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PREFACE 


This publication provides the reader 
with instructions and guidance in writing 
application programs for the IBM 2260 
Display Station (Local Attachment) under 
overall control of the IBM System/360 | 
Operating System. The macro instructions 
and control program routines, which 
constitute a graphics access method for the 
2260, are described in detail. Coding 
examples with accompanying explanations are 
included to illustrate uses of the macro 
instructions. 


To take full advantage of the operating 
system and the programming services 
provided specifically for the 2260 display 
station, the reader should have completed a 
basic course in System/360 Assembler 
Language coding or have equivalent 
knowledge. He should also be familiar with 
the content of the following publications: 


IBM System/360 Component Description: 
IBM 2260 Display Station; IBM 2848 
Display Control, GA27-2700 


IBM System/360 Operating System: 
Introduction, GC28-6534 


Assembler Language, GC28-6514 


Ninth Edition (January, 1972) 


This is a major revision of and obsoletes GC27-6912-7. 
Problem determination aids (in the form of 
write-to-programmer messages for error conditions) 
have been added to Graphic Programming Services. This 
revision contains changes to return codes associated 
with the error conditions. (The messages themselves 


are described in IBM System/360 Operating System: 


Problem Determination Aids and Messages and Codes for 
GPS_and GSP, GC27-6970.) Changes to the text and 


illustrations are indicated by a vertical line to the 
left of the change. 


This edition applies to Release 21 of IBM System/360 
Operating System and to all subsequent releases until 
otherwise indicated in new editions or Technical 
Newsletters. Changes are continually made to the 
information herein; before using this publication in 
connection with the operation of IBM Systems, consult 
the latest SRL Newsletter, GN20-0360, for the editions 
that are applicable and current. 


Supervisor Services and Macro 
Instructions, GC28-6646 


Data Management Services, GC26-3746 


Data Management Macro Instructions, 
GC 26-3794. 


Job Control Language Reference, 
GC28-6704 


Linkage Editor and Loader, GC28-6538 


Data Management for System 
Programmers, GC28-6550 


MFT Guide, GC27-6939 


MVT_ Guide, GC28-6720 


For information to help determine and 
solve problems that involve display 
programs that use Graphic Programming 
Services (GPS) for the 2260 display 
station, see: 


IBM System/360 Operating System: 
Problem Determination Aids and 


Messages and Codes for GPS and GSP, 
GC27-6970 


This publication was prepared for production using an IBM computer to 


update the text and to control the page and line format. 


Page impres- 


Sions for photo-offset printing were obtained from an IBM 1403 Printer 


using a special print train. 


Copies of this and other IBM publications can be obtained through IBM 


branch offices. 


A form for reader's comments appears at the back of this publication. 
Address any additional comments concerning the contents of this 
publication to IBM Corporation, Programming Publications, Department 


636, Neighborhood Road, Kingston, New York 12401 
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The programming support described in 
this publication may be used with one or 
more IBM 2260 Display Stations connected to 
an IBM System/360 central processing unit. 
Each display station iS associated with an 
IBM 2848 Display Control, which is con- 
nected directly to the processing unit 
through either a multiplexer channel or a 
selector channel. 


In this configuration, which is referred 
to as the "IBM 2260 Local,” and in the "IBM 
2260 Remote" configuration described below, 
the display station may be located anywhere 
within a 2000-foot cable distance from the 
display control. 


By using the IBM 2701 Data Adapter Unit 
and appropriate common carrier facilities, 
display controls may be located any dis- 
tance from the central processing unit. 
This configuration, which is referred to as 
the "IBM 2260 Remote," is supported under 
the Basic Telecommunications Access Method 
(BTAM) and the Queued Telecommunications 
Access Method (QTAM). 


CONFIGURATIONS AND FEATURES 


There are two models of the IBM 2260 
display station, Models 1 and 2. Each is a 
cathode-ray tube (CRT) display and is 
available with or without an alphameric, 
numeric, or data entry keyboard. The 
optional keyboard makes man-machine com- 
munication possible on a continuing basis 
at the display station. Other special fea- 


Pen eee eae ae ee +------------7-------- 
| Characteristic {| Model 1 | 
|---------------------- ------------ {-----—-- 
| Model No. of Display | 2 | 2 

| Stations to be Used | | 
|---------------------- +------------ +-------- 
| Max. No. of Display | 24 [ 16 

| Stations | | 
}-------~-------------- +------------ }-------- 
| No. of Lines of | 6 | 12 

| Characters [ | 
}---------------------- +~----------- +-------- 
| No. of Characters | 40 | 40 

| Per Line | | 
}---------------------- $------------ +-------- 
{| Total No. of Charac- | 240 | 480 

| ters [ | 
Se ee Be es ee y eee erent 


Figure 1. Display control characteristics 
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tures available with the IBM 2260 Local are 
Line Addressing and Nondestructive Cursor. 


The IBM 2848 Display Control contains 
the interface control, a character genera- 
tor, and buffer storage for the display 
stations. This buffer storage retains the 
video data to maintain display regeneration 
on the CRT. The data formats and number of 
characters that may be displayed on the 
face of the CRT, as well as the number and 
model of display stations that may be 
attached to a single display control, 
depend on which model of the display con- 
trol is used, as shown in Figure 1. 


Models 21 and 22 of the IBM 2848 provide 
special capabilities for aiding data entry 
applications. These include extra keyboard 
character buffering and input/output com- 
mands that cause the keyboard of the 
addressed display station to remain mechan- 
ically locked to gain the attention of the 
Operator. Models 21 and 22 may be used 
only in combination with an IBM 2260 Model 
2s 


In addition, one IBM 1053 Printer Adapt- 
er Unit may be attached to each display 
control. This feature allows an IBM 1053 
Printer to be used at a central location to 
document and record periodic system trans- 
actions. Like the display stations, the 
1053 printer may be located up to 2000 feet 
from the display control. 


The programming services described in 
this publication support all of the option- 
al features of both the IBM 2260 and the 


ee ey ee Gee ee AT We ton ee ee Oe open Ngo Np ee mer 
| Model 3 | Model 21 | Model 22 | 
----}-----—------ $------------ +------------ : 
| 1 | 2 | 2 | 

| | | | 
~---}+——---------- +------------ +~----------- { 
| 8 | 24 | 16 | 

| | | | 
Sears | areas ae ear | a a eee { 
l 12 l 6 | 12 | 

| | | | 
~---}------------ }------------ +------------ { 
| 80 40 | 40 | 

| | | | 
SSeS eee | ae ea | eae 4 
| 960 {| 240 | 480 | 
Paes een: | ere | eee 
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IBM 2848 described in detail in IBM System/ 


360 Component Description: IBM 2260 Dis- 


play Station; IBM 2848 Display Control, 
GA27-2700. 


PROGRAMMING SUPPORT 


Operating system programming support for 
the IBM 2260 Display Station includes macro 
instructions and control routines. They 
are used for two functions: input/output 
control and attention handling. The macro 
instructions function as part of the appli- 
cation program; the control routines func- 
tion as part of the control program. This 
programming support constitutes a graphics 
access method for the 2260 display station. 


The following paragraphs contain brief 
descriptions of the graphic programming 
services that are explained in detail in 
later sections. Appendixes include a 
sample program and CCW formats. 


INPUT/OUTPUT CONTROL 


Input/output control macro instruc- 
tions are used for data transmission and 
control functions, for creating data con- 
trol blocks (DCBs), and for establishing 
and terminating system communication 
between problem programs and display sta- 
tions. Input/output control routines cre- 
ate channel command words (CCWs), issue 
supervisor calls to execute channel pro- 
grams, and control data transmission 
between main storage and display station 
buffer storage. 


ATTENTION HANDLING 


Attentions are asynchronous (unsched- 
uled) input/output interruptions of the 
CPU. They are caused by entries at a key- 
board attached to a 2260 display station. 


Basic Attention Handling 


Basic attention handling facilities 
automatically detect the occurrence of 2260 
attentions, and the control program routes 
them to the specified application program 
routines for handling. Through a set of 
macro instructions provided by graphic pro- 
gramming services (SAEC, SPAR, ATTNINOQ, and 
DAR), the application programmer defines 
his attention handling routines and makes 
them accessible to the control program. 


Express Attention Handling 


Express attention handling facilities 
enable the application programmer to check 
for the occurrence of 2260 attentions 
through a set of macro instructions pro- 


vided by graphic programming services (ANA- 
LYZ and GSERV). Detection of attentions is 
not automatic; the application program must 
check periodically for their occurrence, so 
that attentions are not lost. When atten- 
tions are detected, control is transferred 
to the specified application program rou- 
tines. (Express attention handling is 
described in Appendix C.) 


ERROR HANDLING 


Synchronous errors (that is, input/ 
output errors that occur during channel 
Operations) are handled by the IBM 2260 
Standard Error routine. This module tests 
the status and sense bytes for synchronous 
error conditions and provides appropriate 
error-recovery procedures for specific 
error Situations. 


The IBM 2260 Standard Error routine pro- 
vides a message to the operator whenever 
operator intervention is required, or 
whenever a bus out check or equipment check 
occurs. These messages appear in the pub- 


lication IBM System/360 Operating System: 
Messages and Codes, GC28-6631. 


PROBLEM DETERMINATION 


For information to help determine and 
solve problems that involve display pro- 
grams that use Graphic Programming Services 
(GPS) for the 2260 display station, see IBM 


System/360 Operating System: Problem 


Determination Aids and Messages and Codes 
for GPS and GSP, GC27-6970. This manual, 


which is intended mainly for display opera- 
tors and application programmers, includes: 


e Display operator aids for image pro- 
blems, interaction problems, messages, 
job termination, and collecting problem 
data. | 


e Application programmer aids, including 
summaries of completion and return 
codes, explanations of write-to- 
programmer messages issued by GPS, pro- 
cedures for using the Generalized Trace 
Facility (GTF), and descriptions of 
problem-related data to be collected. 


SYSTEM GENERATION 


The 2260 programmer defines his graphic 
configuration to the operating system by 
uSing appropriate system generation macro 
instructions. System generation require- 
ments are described in the publication IBM 


System/360 Operating System: System 
Generation, GC28-6554. 


MULT IPROGRAMMING WITH A VARIABLE NUMBER OF 
TASKS (MVT) 


Capability for multiprogramming with a 
variable number of tasks is provided by the 
graphic programming services described in 
this publication. When special considera- 
tions apply to the use of these services in 
an MVT environment, these considerations 
will be noted at the end of the section to 
which they apply. 


FORMAT ILLUSTRATION CONVENTIONS 


Each macro instruction discussed in this 
publication is illustrated by the following 
coding format: 


ee ee eg ee ae ep se 
{Operation |Operand | Comments | 


t------ }---------- $-------------- $-------- { 


|Symbol|Macro name|None, or one | 


| 
| or {or more oper- | | 
{blank | |ands separated | | 
| | | by commas | | 
aeRO! Le LEN a a ne RLM, ASE er eRe CARER UR mE See cree me | 


The coding format illustrations use the 
following conventions: 


e Upper case (capital) letters, numbers, 
and punctuation marks must be coded by 
the programmer exactly as shown. 
Exceptions to this convention are 
brackets, [{ ], braces,i }, and 
ellipses, ... . These three exceptions 
are never coded. 


e Lower case (small) letters represent 
variables for which specific informa- 
tion or specific values must be substi- 
tuted by the programmer when coding. 


e Items within brackets, [ ], are option- 
al. They may be omitted at the pro- 
grammer's discretion. 


e Braces, { }, indicate that one operand 
from the group must be chosen unless a 
default option is indicated. 


e Underscoring indicates a default 
option; if no operand is coded, the 
underscored operand is assumed. 


e The vertical stroke ( | ) signifies 
exclusive "or." For example, A|B means 
the programmer may write A or B. 
Alternative operands are also indicated 
by vertical grouping within braces { }. 


e An ellipsis, ... , denotes that the 
preceding syntactical unit (enclosed in 
braces or brackets) can be written any 
number of times. 


e Operands are separated by commas. 


e All operands are written on one line of 
a coding sheet (unless a continuation 
card is used); they may appear on two 
or more lines in the format 
illustration. 


e The last operand is always followed by 
a blank. 


Positional operands must be coded in the 
order shown in the appropriate format il- 
lustration. Keyword operands may be writ- 
ten in any order, but must follow all posi- 
tional operands. Commas must appear in 
place of omitted operands preceding the 
last-specified positional operand. 


To determine how the operands are to be 
coded when substitution is required, a Sum 
mary of Operands is provided in Appendix D. 
This appendix contains all macro instruc- 
tions and indicates the method of writing 
operands. The summary is designed so it 
can be opened and the macro instructions 
displayed while the descriptions are read. 
The classifications used in the summary 
are: 


SYM 
1s any symbol valid in the assembler 
language. 

DEC INT 

are any decimal digits up to the value 

indicated in the associated macro 

instruction description. If both SYM 
and DEC INT are checked, an absolute 
expression is also allowed. 

REGISTER 

is always coded within parentheses as 

follows: 

(2-12) - one of general registers 2 
through 12, previously loaded 
with the right-adjusted value 
or address specified in the 
associated macro instruction 
description. The unused 
high-order bits must be set 
to zero. The register may be 
designated by either an abso- 
lute expression or a symbolic 
name enclosed in parentheses. 

(1) - general register 1, previous- 
ly loaded as indicated above. 
The register can be desig- 
nated oniy as (1). 

RX TYPE 


any address that is valid in a RX-type 
instruction (for example, LA) may be 
designated. 
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ADCON TYPE 
any address that may be written in an 
A-type address constant may be 
designated. 


Indexing or register notation cannot be 
used if the L form of a macro instruction 
is used or if the macro-form (MF) operand 
is omitted; only relocatable expressions, 
absolute expressions, or codes may be used. 
When using the L-form of a macro instruc- 
tion, the name field should contain a sym- 
bolic reference. 


Unless otherwise noted, numeric values 
indicated as macro instruction operands are 
decimal integers, and they need not be pre- 
ceded by leading zeros. 


Unless otherwise noted, omission of the 
macro-form (MF) operand causes a macro 
instruction to perform both L and E func- 
tions, that is, to derive a parameter list 


from all the operands specified and, at 
execution time, to execute the macro 
instruction using that list. 


LINKAGE CONVENTIONS 


Linkage conventions described in IBM 
System/360 Operating System: Supervisor 
Services and Macro Instructions, GC28-6646, 
apply to the programming support described 
here. Information about register assign- 
ments for specific linkage functions can be 
found in that publication. 


TERMINOLOGY 


In this publication, “display station 
buffer storage" refers to the buffer 
storage physically located in the display 
control unit, and the unqualified term 
"register" means “general register." 


Input/output control is achieved through 
macro instructions and associated control 
routines which together initiate input/ 
output operations associated with data dis- 
play. The input/output macro instructions 
and their functions for the IBM 2260 Dis- 
play Station are listed in Figure 2. 


Note: The address of the application pro- 
gram save area must be loaded into register 
13 before any input/output macro instruc- 
tion is issued. 


BACKGROUND INFORMATION 


To help the reader better understand a 
discussion of input/output operations, the 
following paragraphs briefly describe the 
functional relationships among the various 
system control blocks associated with 2260 
input/output operations under the operating 
system. Additional information may be 
found in IBM System/360 Operating System: 


Data Management for System Programmers, 
GC28-6550. 


Normally, each data control block (DCB) 
is established by a DCB macro instruction 
and completed by execution of an OPEN macro 
instruction. The DCB, which contains a 
reference to a DD statement (see below), 
may be associated with one display station 
or with a group of display stations con- 
nected to a Single 2848 display control. 


(--- 


INPUT/OUTPUT CONTROL 


More than one DCB may be completed by a 
Single OPEN macro instruction. The OPEN 
macro instruction creates a data extent 
block (DEB) in protected main storage. 
Included in the DEB is a tabie of address 
pointers to specific unit control blocks 
(UCBs) associated with the data control 
block. One UCB is specified for each dis- 
play station and for each 1053 printer 


“attached to a 2848 display control. The 


UCB is used to describe its associated 
device to the control program. 


Some input/output macro instructions 
contain a “unit™ operand. The "unit" 
operand refers to a device within a group 
of devices that can be named during system 
generation. This operand is used as an 
index to reference the desired element in 
the DEB list of UCB pointers. The value of 
the “unit" operand, expressed as a decimal 
integer, must not exceed the number of 
devices specified on the data definition 
(DD) card for the data set. 


A DD statement can refer to any display 
station or 1053 printer singly or to any 
group of display stations (up to 24) 
together with a 1053 printer connected to 
the same display control. All units of a 
group need not be specified in one DD sta- 
tement; subsequent DD statements can refer 
to the unspecified units in that group. 
Information about data definition specifi- 
cations can be found in IBM System/360 


ge oa ee et ee a ae Mis gee ee een ee Pye eg ee ee es ee 1 
| ‘Mnemonic | Macro Instruction Name | Function | 
}---------- $----------------------------- }-----~-~-------+------------------------------ 
| DCB | Data Control Block | Establishes the data control block (DCB). | 
|---------- ~--~---~---------------------- }-----------------~---------------------------- 
| OPEN | Open Data Control Block | Initializes one or more data control blocks. | 
o-oo tases oe ee poe ee eee ee ee | 
| GREAD | Read Character Data | Transmits data from the display station | 
| | | buffer storage to main storage. | 
}---------- {----------------------------- 4{~------------=---------------+---------------- 
| GWRITE | Write Character Data | Transmits data from main storage to the dis- | 
| | | play station buffer storage or to a 1053 | 
| | | printer. | 
[=SSes>-s= qe ee Dee ee ee 
| GCNTRL | Erase Display Station | Exrases data from the display station buffer | 
| | Buffer Storage | storage. | 
|---------- {----------------------------- }---------------------------------------------- { 
{| CLOSE {| Close Data Control Block | Disassociates one or more data control | 
| | | blocks. | 
|------—---- }----------------------------- }---------------------------------------------- 
| WAIT | Wait for One or More Events | Relingquishes control of the CPU until the | 
| | | completion of one or more input/output | 
| | | operations. | 
Ea ane ee er area ie eee lS ee ee ae a ee ee J 
Figure 2. Input/output macro instructions 
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Operating System: Job Control Language 
Reference, GC28-6704. 


The value of the "unit" operand decre- 
mented by 1 is placed in the data event 
control block (DECB) when it is generated 
during macro expansion ("unit" - 1 = UCB 


index). At execution time, the input/output 


control routine places this value into the 
input/output block (IOB). This completes 
the linkage between the input/output macro 
instruction and the selected UCB, which in 
turn points to the device associated with 
the macro instruction. 


INPUT/OUTPUT MACRO INSTRUCTIONS 


The macro instructions in this group 
implement 2260 input/output functions, 
which include defining certain control 
blocks and controlling data transmission 
between main storage and the display sta- 
tion buffer storage. These macro instruc- 


the macro instruction operands are inserted 
into appropriate positions in the DECB. 
This data is utilized by the input/output 
control routine to generate the CCWs. The 
format of the DECB for the IBM 2260 Local 
is shown in Figure 3. 


DCB-~-Data Control Block Macro Instruction 


The DCB macro instruction for the IBM 
2260 Local reserves space for the data con- 
trol block and establishes its format (see 
Figure 4). In addition to the basic infor- 
mation required in the DCB, Space is also 
reserved for addresses of the input/output 
control routine and the input/output block, 
which are supplied at open time. One DCB 
services a maximum of 24 display stations 
and one 1053 printer attached to the same 
display control. The format of the DCB 
macro instruction is: 


tions provide linkage to the input/output | Name | Operation|Operand 1 
control routine that creates the IOB, con- ae ee ee r 
structs channel programs, and issues cal- | [symbol] | DCB | DSORG=GS, MACRF=code | 
ling sequences to execute the channel | | | (,GTYPE={BASIC|EXPRESS}] | 
programs. | | | [, DDNAME=ddname] { 
| { | {,EXLST=exit list address] | 
All input/output macro instructions | | | £,GNCP=number of blocks] | 
except the DCB macro instruction may use | | | {,POLST=poll list address] | 
the L- and E-forms of macro definition. If ‘-------- Seen Se ee —— 
all operands except the MF=L or MF=E key- 
word word operand are written, the input/ 
output function is executed using the spec- DSORG=GS 
ified operands. If any required operand is specifies that a graphic data control 
missing at execution time the task is ter- biock is defined. This operand is 
minated. Detailed descriptions of these required for macro expansion. 
forms and their use are found in IBM 
System/360 Operating System: Supervisor MACRF= 
Services and Macro Instructions, GC28-6646. Specifies the type or types of macro 
| instructions to be used, where R indi- 
A 32-byte DECB is formed during macro cates GREAD, W indicates GWRITE, and C 
expansion, and the parameters derived from indicates GCNTRL. The following are 
a Mee re ee NE TCS ery eg See ET pt ee ey ego Wee ot we 
{| Offset from | | Associated I/O _ | 
| DECB Name _ | | Macro Instruction | 
{ (bytes) | DECB Field | Operand | 
[------------- }---------------------------—----------------------— {------------------- { 
| +00 {| Event control block (ECB) | i 
| +04 {| Type code [ type | 
i +08 | Data control block (DCB) address | dcb address { 
{ +12 {| Area address | area address | 
{ +16 {| Code for incorrect length or permanent read error | | 
| +17 {| Residual count from CSW if incorrect length | | 
| +20 | Length (byte count) [ length [ 
| +24 | (Reserved) | | 
| +28 {| Index to reference an element in the DEB table of | unit ; 
[ | address pointers to UCBS associated with the DCB | [ 
| +29 | Zero (the low order bit of this byte is set to one | ; 
| | when data entry type codes are specified) | [ 
{ +30 {| Zeros | | 
[ +31 | Zeros | | 
Ete ec ear aera a a ee Ee ens a mn ee Meee ae J 


Figure 3. Format of the DECB 


ma aa aca a cs ae oan ee eee te RE Se I Pee ee ee a eee re Pe eee ee 1 
| Offset from | | 
| DCB name | | 
| (bytes) | DCB Field | 
}-------------- }~---------------------------------------------—------------------------ { 
| +0-13 | Reserved | 
| +14 | GTYPE--Specifies basic or express attention handling procedures | 
| #15-25 | Reserved : | 
| +26-27 | DSORG--Specifies a graphic data control block | 
| +28-31 | Reserved | 
| +32 | GNCP--Maximum number of I/O macro instructions issued before a | 
| | WAIT macro instruction is issued | 
| +33-35 | POLST--Address of list of DCB addresses used in express | 
| | attention handling | 
| +36 | Reserved | 
| +37-39 | EXLST--Address of application program exit list for exceptional | 
| | conditions | 
| +40-47 | DDNAME--Corresponds to name of data definition (DD) statement | 
| +48-49 | Reserved | 
| +50-51 | MACRF--Types of I/O macro instructions used in problem program | 
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Figure 4. Data control block elements 


the eight valid codes for the MACRF 


issued before a WAIT macro instruction 


operand. (that is, the number of input/output 
blocks constructed at open time). The 
R value of GNCP must be from 1 to 99 at 
W execution time. If the value of GNCP 
RC is not specified, a value of one is 
WC assumed. The programmer may specify a 
(R, W) value of zero at assembly time, but 
(RC,W) must respecify the value within the 
(R, WC) above range at execution time. If the 
(RC ,WC) value zero is present at open time, 
the job is abnormally terminated. 
GTYPE= 


Specifies whether basic or express 
attention handling procedures are to 
be employed. If this operand is 
omitted, express attention handling is 
assumed. 


DDNAME= 


Specifies the name of the DD statement 
describing the data set being pro- 
cessed. DDNAME corresponds exactly to 
the contents of the Name field of the 
DD statement provided in the job con- 
trol language. It can be defined by 
as many aS eight characters, the first 
of which must be a letter. DDNAME 
furnishes a logical connection between 
the DD statement and the data control 
block of the application program. 


EXLST= 


GNCP= 


Specifies the address of the exit list 
in the application program as defined 
in the publication IBM System/360 Op- 
erating System: Supervisor Services 
and Macro Instructions, GC28-6646. If 
EXLST is not specified, a value of 
zero iS assumed. 


Specifies the maximum number of input/ 
Output macro instructions that can be 


POLST= 


is the address of the location in main 
storage, reserved by the application 
programmer, where a list of DCB 
addresses is constructed by the OPEN 
macro instruction. This list of DCB 
addresses, called a poll list, is used 
with express attention handling faci- 
lities by the OPEN, CLOSE, GSERV, and 
ANALYZ macro instructions as described 
in Appendix C of this publication. 

The first entry in the poll list 
points to the last entry. (It must 
originally be set to zeros.) As addi- 
tional devices are opened, the DCB 
addresses are added to the poll list. 
The length of the area needed to con- 
struct the list is nt1 fullwords, 
where "n" is the number of devices for 
which the DCB is opened. If the app- 
lication programmer wishes to open 
multiple DCBs using the same OPEN 
macro instruction, he must use the 
same POLST operand with each DCB macro 
instruction he issues. He may use the 
same POLST operand or different POLST 
operands when issuing other OPEN macro 
instructions. If more than one poll 
list is created, each requires a 
separate ANALYZ macro instruction. If 
POLST is not specified, a value of 
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zero is assumed. This operand is used 
only with express attention handling. 


PROGRAMMING NOTES: The application pro- 
grammer may create a DCB at assembly time 
by using the DCB macro instruction. Data 
definition (DD) card information may be 
supplied by the programmer at execution 
time. The GNCP operand may be specified at 
execution time by a DD card, provided GNCP 
is set to zero at assembly time. 


The application programmer can create 
his own DCB by using a constant area. In 
this case he may specify both the DSORG and 
GNCP operands ina DD card. By ensuring 
that this area contains the same informa- 
tion at the same locations as the DCB 
created by the DCB macro expansion (see 
Figure 4), the programmer can effectively 
create a DCB. The DD name of the DD card 
must be identical to the DD name set up in 
this area (offset 40 through 47). For 
information on coding of the DD card, refer 


to IBM System/360 Operating System: Job 
Control Language Reference, GC28-6704. 


The data control block assembled from a 
DCB macro instruction will not have names 
associated with the individual fields that 
comprise the control block. To refer or 
gain access to the fields in the data con- 
trol block, the application programmer can 
write a DCBD macro instruction as follows: 


DCBD DSORG=GS 


The name field must be left blank, 
the DSORG operand is specified. 


and only 


The DCBD macro instruction generates a 
DSECT statement that provides a symbolic 
name for the fields within a data control 
block. Each field is defined so that with 
proper initialization of base registers, 
the programmer can refer to any or all 
fields of one or more data control blocks. 
The macro instruction expands as follows: 


+* DCB SYMBOLIC DEFIN- 
+* ITION FOR GRAPHICS 
+* WITH APPENDAGES 
+ITHADCB DSECT 

+ ORG IHADCBt0 

+* GRAPHIC DEVICE 

+* INTERFACE 

+ DS BL4& 

+ DS BL4& 

+ DS BL4 

+DCBBRSA DS AL2 

+DCBGTYPE DS BL1 

+ DS BL1 

+DCBBFRST DS AL2 

+DCBBFRSZ DS AL2 


+* COMMON 
+ ORG IHADCB+20 
+ DS BL6 


+DCBDSORG DS BL2 
+DCBIOBAD DS A 


+* FOUNDATION EXTENSION 


+ ORG IHADCB+32 
+DCBGNCP DS OBL1 
+DCBPOLST DS A 
+DCBEXLST DS A 


+* FOUNDATION BEFORE 
+* OPEN 
+ ORG IHADCB+t+40 


+DCBDDNAM DS CL8 
+DCBOFLG DS BL1 
+DCBIFLG DS BL1 
+DCBMACR DS BL2 


+* FOUNDATION AFTER 
+* OPEN 
+ ORG IHADCB+40 


+DCBTIOT DS AL2 
+DCBMACRF DS BL2 
+DCBIFLGS DS OBL1 
+DCBDEBAD DS A 
+DCBOFLGS DS OBL1 
+DCBGIOCR DS A 


For more information, see IBM System/360 


Operating System: Data Management Macro 
Instructions, GC26-3794. 


OPEN--Open Data Control Block Macro 
Instruction 


The OPEN macro instruction for the IBM 
2260 Local initializes one or more data 
control blocks that establish a communica- 
tion path between the application program 
and the display station. OPEN performs the 
following functions: 


e Indicates that the display station is 
"open" by setting the appropriate bit 
in the DCB. 


e Fills in and initializes appropriate 
fields in the DCB. 


e Acquires main storage to initialize a 
chain of IOBs and associated channel 
programs. Linkage is provided in the 
IOB to its CCW list and to the next IOB 
in the chain. The number of IOBS con- 
structed is one greater than the number 
specified by the GNCP operand, unless 
GNCP is equal to 99. (No more than 99 
IOBs may be constructed for each DCB.) 
The additional IOB is constructed in 
order to always ensure the availability 
of an IOB, since IOBS are not con- 
structed dynamically. A pointer to the 


top of the chain of IOBsS is placed in 
the DCB. 


e Loads the graphic I/O control routine 
and places its address in the DCB. 


e Performs initialization functions 
required by attention handiing facili- 
ties. If the POLST operand was speci- 
fied in the DCB macro instruction, a 
DCB address list (poll list) is con- 
structed. OPEN provides one POLST 
entry for every display station that 
the user wants polled. This function 
applies only to 2260s equipped with an 
optional keyboard feature. 


The format of the OPEN macro instruction 


aaa cama St a aa mea | 
| Name | O(peration| Operand | 
--------}--------- $---------------------- 
| [Symbol] | OPEN | (dcb address | 
| { |{,,dcb address]...) | 
i | | C,MF={L|(E, parameter | 
| | {| list name) |(E,(1))}] | 
Spe ae eee a B Epaiee eee arama ee ag ny a a ane ea NS 


dcb address 
specifies the addresses of the DCBs to 
be initialized for the desired graphic 
device(s). Any number of DCB address- 
es may be specified. This allows 
parallel opening of DCBs and their 
associated data sets. If more than 
one DCB address is specified, the “dcb 
address" operands must be separated by 
two commas. The second comma indi- 
cates omission of optional operands 
not applicable to graphic programming 
services. 


MF=L 
specifies that expansion of the macro 
instruction is to consist of a parame- 
ter list only. The name assigned to 
the parameter list is the symbolic 
name specified in the Name field of 
this OPEN macro instruction. 


MF=(E, parameter list name) 
specifies that the macro instruction 
is to perform the open function using 
a parameter list created by another 
OPEN macro instruction. The open 
function is executed for each “dcb ad- 
dress™ operand in the list. The “pa- 
rameter list name" operand must corre- 
spond exactly to the name specified in 
the Name field of the OPEN macro 
instruction used to construct the pa- 
rameter list. 


MF=(E, (1)) 
performs the same function as (E, 
parameter list name). By writing the 
Special register notation (1), the 


EXAMPLES : 


| 
| 
| 
| 
| 
L 


programmer specifies that he has 
loaded the address of the parameter 
list into register 1 before execution 
of the macro instruction. 


PROGRAMMING NOTES: If a task attempts to 
open a DCB that was already opened by 
another task, the task is abnormally ter- 
minated. If a task attempts to open a gra- 
phics DCB for a nongraphics device, the 
task is abnormally terminated. If a task 
attempts to have OPEN construct a number of 
IOBs that is not in the range 1 through 99, 
the task is abnormally terminated. Write- 
to-programmer messages are issued for these 
error conditions. For message explanations 
and programmer error checks, see IBM 
System/360 Operating System: Problem 


Determination Aids and Messages and Codes 
for GPS and GSP, GC27-6970. 


If the "dcb address" operand of the OPEN 
macro instruction specifies a DCB that was 
already opened (by the same task), no 
action results. Opening when a correspond- 
ing DD statement has not been provided 
causes no error indication; however, an 
attempt to use the data set will result in 
an abnormal termination of the task. 


If the device specified on the DD card 
is not a graphic device, an invalid UCB 
results, and the task is abnormally 
terminated. 


In the second and third 
examples, DCB1 and DCB2 are initialized 
using the parameter list constructed by the 
first example. In the third example, the 
location of the parameter list has been 
loaded into register 1. 


EXAMP1 OPEN (DCB1, ,DCB2) ,MF=L 
EXAMP2 OPEN MF=(E, EXAMP1) 
EXAMP3 OPEN MF=(E, (1)) 


GREAD--Read Character Data Macro 
Instruction 


The GREAD macro instruction transmits 
data from the display station buffer 
storage to main storage. There are six 
possible read operations performed by the 
GREAD macro instruction depending upon the 
"type" operand specified. The format of 
the GREAD macro instruction is: 


| [Symbol] | GREAD |decb name 

| type 

|,dcb address 
|, Clength] 
|,area address 
| C,unit] 

| (, MF={L|E}] 
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decb name 
is the name assigned to the data event 
control block generated in the macro 
expansion. This operand is required 
for macro expansion. 


type 
specifies the type of read operation. 
This operand is required for proper 
macro expansion. The following are 
the valid forms of the operand (each 
"type" is described following the dis- 
cussion of all other operands related 
to the GREAD macro instruction): 


DSM 
Read Display Station Manual Input Mes- 
sage for the 2260. 

DS MW 
Read Display Station Manual Input Mes- 
sage Without Keyboard Restore for the 
2260. 

SMI 
Read Display Station Short Manual 
Input Message for the 2260. 

SMIW 
Read Display Station Short Manual 
Input Message Without Keyboard Restore 
for the 2260. 

DSB 
Read Full Display Station Buffer 
Storage for the 2260. 

DS BW 
Read Full Display Station Buffer 
Storage Without Keyboard Restore for 
the 2260. 


dcb address 
is the address of the data control 
block associated with the graphic 
device. 


length 
is the number of data bytes to be 
read. 


area address . 
is the address of the main storage 
location into which the first byte of 
data will be read. 


unit . 
is a decimal integer; it is used to 
create an index to the desired element 
in the DEB table (address pointers to 
UCBS associated with the DCB). The 
indicated UCB contains the address of 
the desired device. The value of 
"unit" must be in the range 1 to N, 
where N is the number of devices spe- 
cified on the data definition card for 
this data set. N cannot exceed 25 
(the maximum configuration is 24 dis- 
play stations and one 1053 Printer per 
display control). 


Caution: When using register nota- 
tion, the contents of the register, at 
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execution, must be one less than the 
value of the "unit" operand described 
above. 


Note: The device indicated by "unit" 
cannot be the 1053 printer. 


Omission of the "unit" operand 
results in the value one being 
assigned to "unit", indicating the 
first element in the DEB table. 


=L 
specifies that expansion of the macro 
instruction is to consist of a parame- 
ter list only. The name assigned to 
the parameter list is the name speci- 
fied by the “decb name™ operand of 
this GREAD L-form macro instruction. 


MF=E 
Specifies that the macro instruction 
is to perform the read operation using 
a parameter list constructed by anoth- 
er GREAD macro instruction. The first 
operand in the E-form macro instruc- 
tion must correspond exactly to the 
name of the parameter list. The pa- 
rameter list may be updated at execu- 
tion time by specifying new values in 
any of the operands preceding the MF=E 
keyword operand. 


A "type" operand, specified in an L-form 
macro instruction, may be modified by a 
corresponding E-form macro instruction. 
Other operands required for execution that 
were not specified in an L-form macro 
instruction should be specified in the 
corresponding E-form macro instruction. 


Note: A unique name must be assigned to 
each parameter list defined. Use of the 
same DECB name for more than one DECB 
results ina multiple definition error at 
assembly time. 


If neither the MF=L nor MF=E keyword 
operand is written, all required operands 
must be coded to achieve executable macro 
expansion. Omission of the “decb name" 
operand prevents macro expansion; omission 
of other operands produces error messages 
on the assembly listing, but does not ter- 
Minate macro expansion. 


TYPES OF READ OPERATIONS: The six types of 
read operations for the 2260 are described 
below. 


DSM (Read Display Station Manual Input Mes- 
sage): This “type” operand causes charact- 


er data in the selected display station 
buffer storage to be transferred to main 
storage by the display control. DSM can be 
used only if an optional keyboard feature 
is available. Starting with the first dis- 
play position following the start symbol, 


character data will be sequentially retri- 
eved and transferred until the end of mes- 
sage is detected or the channel byte count 
is reduced to zero. The start symbol is 
then cleared. Data on the same line and to 
the right of a new line symbol is not tran- 
Sferred. The new line symbol is trans- 
ferred. If the check symbol is present, it 
is transferred. The end of message code is 
not transferred to main storage. The dele- 
tion of the start symbol is the only change 
to the CRT display; the data is not changed 
or destroyed by the read operation. 


One channel command word is generated by 
GREAD, "type" DSM: the Read Display Sta- 
tion Manual Input Message CCW, which 
initiates the read operation. 


DSMW (Read Display Station Manual Input 


Message Without Keyboard Restore): The 
Operation caused by this “type™ operand, 


which can Only be used with IBM 2848 Models 
21 and 22, is identical to DSM, except that 
the keyboard remains mechanically locked at 
the completion of the operation. 


One channel command word is generated by 
GREAD, “type™ DSMW: the Read Display Sta- 
tion Manual Input Message Without Keyboard 
Restore CCW, which initiates the read 
operation. 


SMI (Read Display Station Short Manual 
Input Message): The operation caused by 


this "type" operand is identical to DSM, 
except that the start symbol is not erased 
when the end of message is detected or the 
channel byte count is reduced to zero. 
Consequently, keyboard lockout time is sub- 
Stantially less for the SMI "type™ operand 
than for the DSM "type" operand. This is 
an important consideration for applications 
involving a high rate of data input and 
multiple 2260s attached to one 2848. 


One channel command word is generated by 
GREAD, “type" SMI: the Read Display Sta- 
tion Short Manual Input Message CCW, which 
initiates the read operation. 


SMIW (Read Display Station Short Manual 


Input Message Without Keyboard Restore): 
The operation caused by this "type" 


operand, which can only be used with IBM 
2848 Models 21 and 22, is identical to SMI, 
except that the keyboard remains mechani- 
cally locked at the completion of the 
Operation. 


One channel command word is generated by 
GREAD, “type” SMIW: the Read Display Sta- 
tion Short Manual Input Message Without 
Keyboard Restore CCW, which initiates the 
read operation. 


DSB (Read Full Display Station Buffer): 
This “type" operand causes a maximum of 


240, 480, or 960 data bytes to be trans- 
ferred, depending upon the size of the 
addressed display station buffer. The 
first symbol transferred is the first sym- 
bol in the upper left-hand corner of the 
CRT, and the last symbol transferred is the 
last symbol in the lower right-hand corner 
of the CRT. If no character is found ina 
displayable position, a space is trans- 
ferred. If the addressed buffer has the 
optional nondestructive cursor feature, the 
cursor position is not indicated by the 
data transferred. If the addressed buffer 
has a standard destructive cursor feature, 
the cursor position is indicated by the 
location of the end of message code. (For 
more information about the cursor features 
and the end of message code, see IBM 
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Display Station; IBM 2848 Display Control, 
GA27-2700.) The check and start symbols 


are transferred if they are present. The 
codes are: 

bit 01234567 
Destructive cursor 011031010 
Check symbol 01131311141 
Start symbol 01003101 0 


The CRT is erased after the operation, 
and the cursor is placed in the first cur- 
sor position (upper left-hand corner) of 


the CRT. 


Multiple channel command words are 
generated by GREAD, “type"™ DSB. First, the 
Read Full Display Station Buffer CCW is 
issued, which initiates the read operation. 
Second, the Erase Display Station Buffer 
Storage CCW is issued, which deletes all 
character data from the display station 
buffer storage and resets the cursor to the 
first display position of the CRT. 


DSBW (Read Full Display Station Buffer 


Without Keyboard Restore): The operation 
caused by this "type" operand, which can 


only be used with IBM 2848 Models 21 and 
22, is identical to DSB, except that the 
keyboard remains mechanically locked at the 
completion of the operation. 


Multiple channel command words are 
generated by GREAD, "type" DSBW. First, 
the Read Full Display Station Buffer 
Without Keyboard Restore CCW is issued, 
which initiates the read operation. 
Second, the Erase Display Station Buffer 
Storage Without Keyboard Restore CCW is 
issued, which deletes all character data 
from the display station buffer storage and 
resets the cursor to the first display 
position of the CRT. 
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PROGRAMMING NOTES: If the channel byte 
count in the CCW reaches zero, a stop 
sequence is generated by the channel. Dur- 
ing a read operation, receipt of the stop 
sequence terminates transmission of data 
from the display control to main storage. 
The display control continues reading data 
from the display station buffer storage but 
does not transfer data to main storage. 
Detection of the end of message when using 
DSM causes the display control to restore 
the keyboard of the selected display sta- 
tion and delete the start symbol. When SMI 
is used, the keyboard is restored and the 
Start symbol is not erased. When DSB is 
used, the display is erased at completion 
of the operation, and the cursor is reset. 
If an error is detected during execution of 
DSB, the eraSe operation is not performed. 
The application programmer, therefore, 
Should ensure that the correct length is 
specified if he wants the erase operation 
to be performed. 


An unspecified "length" operand or zero 
entry results in the insertion of a byte 
count of 960 in the generated CCW. This 
assures that the stop sequence will not be 
encountered on read operations. If the 
"length" operand is incorrectly specified, 
an error message is printed on the assembly 
listing. ' 


Figure 5. 
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- ERROR CONDITIONS : 


If incorrect length 
occurs during execution, the count from the 
CSW is placed in its appropriate location 
in the DECB (DECB+17 through 19), anda 
hexadecimal code of 43 is posted in the 
DECB (DECB+16). Since this case is not 
considered an error, a hexadecimal code of 
7F is also posted in the high-order byte of 
the ECB. If a permanent read error occurs, 
the screen is erased, the message ERROR ON 
READ is displayed, an error code of 41 is 
posted in the high-order byte (byte 0) of 
the ECB, and a hexadecimal code of 45 is 
posted in the DECB (DECBt16). Automatic 
retry is not provided, and the handling of 
the error is entirely the responsibility of 
the application program. 


Before processing the data obtained from 
a read operation, the application program 
should check the high-order byte of the ECB 
to determine whether the operation was suc- 
cessful. The program should then check 
bytes 16 through 19 of the DECB for more 
information about the completion condition. 
If the DECB is to be used for more than one 
input/output operation, the program must 
zero DECB byte 16 before execution of the 
next input/output operation. The indica- 
tions and conditions present when determin- 
ing the completion condition, and the read 
operation affected, are shown in Figure 5. 


fae Ee a ee eee eee ae Se en ee Ree 1 
| Indication | | Condition | Read Operation | 
}--------------------- }--------~-------------------------------------- }----------------- { 
{1. ECB=7F | | | 
| DECB+16=0 | Normal Completion | DSM, DSMW, | 
| DECB+17=not used | | SMI, SMIW, DSB, | 
| | | DSBW | 
{2. ECB=41 | | | 
| DECB+16=45 | Permanent Error | DSM, DSMW, | 
| | DECB+17=not used | | SMI, SMIW, DSB, | 
| | | DSBW | 
j3. ECB=7F | | | 
| DECB+16=43 { Long Length Record | DSM, DSMW, SMI _ | 
| DECB+17=0 | (The CSW count reached zero before the end of | or SMIW | 
| CSW count=0 | message symbol was detected) | | 
| | (The CSW count reached zero before the full | DSB or DSBW | 
| | buffer was read) | | | 
|4. ECB=7F | | | l 
| DECB+16=43 | Short Length Record | DSM, DSMW, | 
| DECB+17=count | (The end of message symbol was encountered | SMI or SMIW | 
| CSW count not | before the CSW count reached zero) | | 
| equal to initial | (The full buffer was read before the CSW | DSB or DSBW | 
| count and not zero| count reached zero) | | 
| | | | 
{5. ECB=7F | | | 
i DECB+16=43 |) a. The ENTER key was depressed when the | DSM, DSMW, SMI_ | 
| DECB+17=initial | Start symbol was not on the screen | or SMIW | 
| count | b. A DSM was given when the ENTER key had | | 
| | not been depressed | | 
| | c. The ENTER key was depressed before any | | 
| | data was entered (the start symbol is | | 
| | followed immediately by the cursor) | | 
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Completion indications and conditions 


After execution of the macro instruc- 
tion, the program should check the hexadec- 
imal return code in register 15 to deter- 
mine whether execution was successful. 
Return codes and their meanings are: 


Return Code Meaning 

00 Normal 

10 DCB address is not in the DECB 

14 DCB addresses in the DECB and 
the IOB are not equal 

1c Type code is not in the DECB 

24 Area address is not in the 
DECB 

28 DCB addresses in the DECB and 
the DEB are not equal 

2C Unit index in the DECB exceeds 
units specified in the DD 
record 

3C Length in the DECB is negative 


Write-to-programmer messages are issued 
for the error conditions. For message 
explanations and programmer error checks, 


see IBM System/360 Operating System: Pro- 


blem Determination Aids and Messages and 
Codes for GPS and GSP, GC27-6970. 


EXAMPLES: In the following example, a DECB 
named DECB1 is to be generated as part of 
the macro expansion. The "type" operand 
Specifies that a DSM operation for the data 
set associated with the data control block 
INDCB will be performed. A length of 100 
bytes will be read into an area in main 
storage called INAREA. The value of the 
"unit" operand is one. In example 1, L- 
form is specified, which generates the 
parameter list. Example 2 shows coding 
when positional operands are omitted in an 
L-form GREAD. Example 3 shows the E-form 
GREAD with the length changed to 150 bytes. 
EXAMP1 GREAD DECB1 ,DSM,INDCB,100, 
INAREA, 1, MF=L 
DECB1,DSM, MF=L 
DECB1,,,150,MF=E 


EXAMP2 GREAD 
EXAMP3 GREAD 


Register Notation: The programmer may 
specify register notation, in which case 


the address of the DECB must be loaded into 
register 1 before execution of the macro 
instruction. Other positional operands may 
be loaded into other registers (2-12). For 
example: 


EXAMP1 LA 
GREAD 


1,DECB 
(1) ,MF=E 
Or 


EXAMP2 LA 1,DECB1 
LA 2, INDCB 
LA 3, INAREA 
GREAD (1),,(2),, (3) ,MF=E 


When expressing the “unit"™ operand in 
register notation, the value loaded into 
the register is the same as the UCB index 
(unit-1) and is placed in the high-order 
byte of the register. 


GWRITE--Write Character Data Macro 
Instruction 


The GWRITE macro instruction transmits 
data from main storage to the display sta- 
tion buffer storage or to a 1053 printer. 
There are eight possible write operations 
performed by the GWRITE macro instruction 
depending upon the “type™ operand speci- 
fied. The format of the GWRITE macro 
instruction is: 


a Sato ee Wa ee es es 
| Name 


t + { 
| (symbol ] | GWRITE |decb name | 
| | | type | 
| | |,dcb address | 
| | |, (Length] | 
| | |,area address | 
| | | (, unit] | 
( 
L J 


| eee ee 


decb name 
is the name assigned to the data event 
control block generated in the macro 
expansion. This operand is required 
for macro expansion. 


type 
specifies the type of write operation. 
This operand is required for proper 
macro expansion. The following are 
the valid forms of the operand (each 
"type" is described following the dis- 
cussion of all other operands related 
to the GWRITE macro instruction): 


DSB 
Write Display Station Buffer Storage 
for the 2260, or Write 1053 Printer 
Bufcer Storage for the 1053. 

DSBW 
Write Display Station Buffer Storage 
Without Keyboard Restore for the 2260. 

EBW 
Erase and Write Display Station Buffer 
Storage for the 2260. 

EBWW 
Erase and Write Display Station Buffer 
Storage Without Keyboard Restore for 
the 2260. 

LNE 
Write Display Station Line Address for 
the 2260. 
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LNEW 
Write Display Station Line Address 
Without Keyboard Restore for the 2260. 
EWL 
Erase and Write Display Station Line 
Address for the 2260. 
EWLW 
Erase and Write Display Station Line 
Address Without Keyboard Restore for 
the 2260. 


dcb address 
is the address of the data control 
block associated with a graphic 
device. 


length 
is the number of bytes of display data 
to be written. This includes the new 
line character and the line address 
control byte when used. 


area address 
is the address of the main storage 
location from which the first byte of 
display data is to be written. 


unit 
is a decimal integer; it is used to 
create an index to the desired element 
in the DEB table (address pointers to 
UCBS associated with the DCB). The 
indicated UCB contains the address of 
the desired device. The value of 
"unit" must be in the range 1 to N, 
where N is the number of devices spe- 
cified on the data definition card for 
this data set. N cannot exceed 25 
(the maximum configuration is 24 dis- 
play stations and one 1053 printer per 
display control). 


Caution: When using register nota- 
tion, the content of the register, at 
execution, must be one less than the 
value of the “unit™ operand described 
above. 


Note: The 1053 printer can be indi- 
cated by “unit” only when the "type" 
Operand is written as DSB. 


Omission of the "unit" operand 
results in the value one being 
assigned to "unit", indicating the 
first element in the DEB table. 


MF=L 
specifies that expansion of the macro 
instruction is to consist of a parame- 
ter list only. The name assigned to 
the parameter list is specified by the 
"“decb" operand of this GWRITE L-form 
macro instruction. 
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MF=E 
specifies that the macro instruction 
is to perform the write operation 
using a parameter list constructed by 
another GWRITE macro instruction. The 
first operand in the E-form macro 
instruction must correspond exactly to 
the name of the parameter list. The 
parameter list may be updated at exe- 
cution time by specifying new values 
in any of the operands preceding the 
MF=E operand. 


A "type" operand, specified in an L-form 
macro instruction, may be modified by a 
corresponding E-form macro instruction. 
Other operands required for execution that 
were not specified in an L-form macro 
instruction should be specified in the 
corresponding E-form macro instruction. 


Note: A unique name must be assigned to 
each parameter list defined. Use of the 
same DECB name for more than one DECB 
results ina multiple definition error at 
assembiy time. 


If neither the MF=L nor MF=E keyword 
operand is written, all required operands 
must be coded to achieve executable macro 
expansion. Omission of the “decb name" 
operand prevents macro expansion; omission 
of other operands produce error messages on 
the assembly listing, but do not terminate 
macro expansion. 


TYPES OF WRITE OPERATIONS: The eight types 
of write operations for the 2260 are 
described below. 


DSB (Write Display Station Buffer Storage): 
This “type"™ operand causes sequential bytes 


of character data to be transmitted to the 
display control in either of two modes 
depending upon whether the address is spec- 
ified as display station or 1053 printer. 


Upon recognition of the display station 
address by the display control, character 
data is placed into the display station 
buffer storage starting at the cursor sym- 
bol position. The cursor is automatically 
advanced to the next cursor position. The 
cursor is placed in the first display posi- 
tion (upper left-hand corner) of the CRT 
when a displayable character is inserted 
into the last display position of the CRT. 


When the 1053 printer address is recog- 
nized by the display control, incoming 
character data is placed into contiguous 
print positions of 1053 buffer storage and 
the 1053 print operation is initiated. A 
new line character should be inserted at 
least after every 130th character; other- 
wise, overprinting results. 


If a write error occurs during execution 
of a GWRITE, “type” DSB, Operation, the. 
system error recovery procedure erases the 
screen completely before initiating a 
retry. 


One channel command word is generated by 
GWRITE, “type” DSB: the Write Display Sta- 
tion Buffer Storage CCW, which initiates 
the write operation. 


DSBW_ (Write Display Station Buffer Storage 


Without Keyboard Restore): The operation 
caused by this “type” operand, which can 


only be used with IBM 2848 Models 21 and 
22, 1S identical to DSB, except that the 
keyboard remains mechanically locked out at 
the completion of the operation. 


One channel command word is generated by 
GWRITE, “type™ DSBW: the Write Display 
Station Buffer Storage Without Keyboard 
Restore CCW, which initiates the write 
operation. 


EBW (Erase and Write Display Station Buffer 
Storage): This "type" operand causes the 


display control to delete all character 
data from the display station buffer 
storage, and to reset the cursor to the 
first display position (upper left-hand 
corner) of the CRT. The display data is 
then placed into display station buffer 
storage, starting with the position at 
which the cursor is reset. 


Two channel command words are generated 
by GWRITE, “type” EBW. First, the Erase 
Display Station Buffer Storage CCW is 
issued to delete all character data from 
the display station buffer storage and 
reset the cursor to the first display posi- 
tion of the CRT. Second, the Write Display 
Station Buffer Storage CCW is issued to 
initiate the write operation. 


EBWW (Erase and Write Display Station Buff- 


er Storage Without Keyboard Restore): The 
operation caused by this “type" operand, 


which can only be used with the IBM 2848 
Models 21 and 22, is identical to EBW, 
except that the keyboard remains mechani- 
cally locked at the completion of the 
operation. 


Two channel command words are generated 
by GWRITE, “type” EBWW. First, the Erase 
Display Station Buffer Storage Without Key- 
board Restore CCW is issued to delete all 
character data From the display station 
buffer storage and reset the cursor to the 
first display position of the CRT. Second, 
the Write Display Station Buffer Storage 
Without Keyboard Restore CCW is issued to 
initiate the write operation. 


LNE (Write Display Station Line Address): 
This “type" operand, which can only be used 


if the line addressing special feature is 
available, causes the display control to 
transmit sequential bytes of character data 
into the display station buffer storage 
under channel byte count control. The 
starting location in the display station 
buffer storage, as indicated in the first 
data byte, is interpreted as a control 
byte. This byte specifies the line to 
which the display data will be transmitted 
(see Figure 6). The cursor is moved to the 
first display position of the line indi- 
cated and display data is placed into dis- 
play station buffer storage starting at the 
position of the cursor symbol. The cursor 
is automatically advanced to the next dis- 
play position. 


LNE performs essentially the same opera- 
tion as DSB. The basic difference is that 
information in the first data byte (a hexa- 
decimal value in the range FO through FB), 
which must be supplied by the user, speci- 
fies the line to which the display data 
will be transmitted. 


One channel command word is generated by 
GWRITE, “type” LNE: the Write Display Sta- 
tion Line Address CCW, which initiates the 
write operation. 


LNEW (Write Display Station Line Address 


Without Keyboard Restore): The operation 
caused by this "type" operand, which can 


only be used with IBM 2848 Models 21 and 
22, is identical to LNE, except that the 
keyboard remains mechanically locked out at 
the completion of the operation. 


One channel command word is generated by 
GWRITE, “type” LNEW: the Write Display 
Station Line Address Without Keyboard Re- 
store CCW, which initiates the write 
operation. 7 


SS oct ee eee oe 
| Bit Positions | Hex. | Selected | 
{01234567 | Equiv. | Line | 
|----------------- }-------- }-------------- { 
}$112112120000 FO | one | 
1111210001 | F1 | two | 
$}1121210010 | F2 | three | 
} 11110011 | F3 | four [ 
$1121210100 F4 | five | 
{/ 27211101201 | F5 | Six | 
1111210110 F6 | seven | 
}1112101i11 | F7 | eight | 
111111000 | F8 | nine | 
{/11111001 | F9 | ten | 
{11212121010 ff FA | eleven [ 
}112121101i1 | FB | twelve | 
ieee No ares apa epee ee a OR ares bce Ms abet eee een eoettks J 
Figure 6. Format of first data byte for 


line addressing operations 
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EWL (Erase and Write Display Station Line 
Address): This "type" operand, which can 


be used only if the line addressing special 
feature is available, causes the display 
control to delete all character data from 
the display station buffer storage, and 
resets the cursor to the first display 
position (upper left-hand corner) of the 
CRT. The cursor is moved to the first dis- 
play position of the specified line, and 
the display data is placed into the display 
station buffer storage starting at the 
position of the cursor symbol. The cursor 
is automatically advanced to the next dis- 
play position. 


EWL executes the same operation as LNE, 
except that an erase operation is performed 
first. 


Two channel command words are generated 
by GWRITE, "type" EWL. First, the Erase 
Display Station Buffer Storage CCW is 
issued to delete all character data from 
the display station buffer storage and 
reset the cursor symbol. Second, the Write 
Display Station Line Address CCW is issued 
to initiate the write operation. 


EWLW (Erase and Write Display Station Line 


Address Without Keyboard Restore): The 
Operation caused by this “type™ operand, 


which can only be used with the IBM 2848 
Models 21 and 22, is identical to EWL, 
except that the keyboard remains mechani- 
cally locked at the completion of the 
operation. 


Two channel command words are generated 
by GWRITE, “type™ EWLW. First, the Erase 
Display Station Buffer Storage Without Key- 
board Restore CCW is issued to delete all 
character data from the display station 
buffer storage and reset the cursor symbol. 
Second, the Write Display Station Line 
Address Without Keyboard Restore CCW is 
issued to initiate the write operation. 


ERROR CONDITIONS: A normal completion is 
indicated by a hexadecimal code of 7F in 
the high order byte of the ECB (byte 0). 
If a permanent error occurs, a hexadecimal 
code of 41 is posted in this byte. 


After execution of the macro instruc- 
tion, the program should check the hexadec- 
imal return code in register 15 to 
determine whether execution was successful. 
Return codes and their meanings are: 


Return Code Meaning 
00 Normal 
10 DCB address is not in the DECB 
14 DCB addresses in the DECB and 


the IOB are not equal 
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1c Type code is not in the DECB 

24 Area address is not in the 
DECB 

28 DCB addresses in the DECB and 

— the DEB are not equal 

2c Unit index in the DECB exceeds 
units specified in the DD 
record 

3C Length in the DECB is negative 


Write-to-programmer messages are issued 
for the error conditions. For message 
explanations and programmer error checks, 


see IBM System/360 Operating System: Pro- 


blem Determination Aids and Messages and 
Codes for GPS and GSP, GC27-6970. 


EXAMPLES: In the following examples, a 
DECB named DECB1i is to be generated as part 
of the macro expansion. The "type™ operand 
specifies a DSB operation for the data set 
associated with the data control block OUT- 
DCB. One hundred bytes of data will be 
written from an area in main storage called 
OUTAREA. The value of the "unit" operand 
is 1. In Example 1, L-form is specified to 
generate the parameter list. Example 2 
Shows coding for an L-form GWRITE macro 
instruction when positional operands are 
omitted. Example 3 shows coding for an 
E-form GWRITE macro instruction with the 
length changed to 150 bytes. 

EXAMP1 GWRITE DECB1 ,DSB,OUTDCB,100, 
OUTAREA, 1, MF=L 


EXAMP2 GWRITE DECB1, DSB, MF=L 


EXAMP3 GWRITE DECB1,,,150,MF=E 


Register Notation: The programmer may 
specify register notation. The address of 


the DECB must be loaded into register 1 
before execution of the macro instruction. 
Other positional operands may be loaded 
into other registers (2-12). For example: 


EXAMP1 LA 1,DECB1 
GWRITE (1) ,MF=E 
or 
EXAMP2 LA 1,DECB1 
LA 2, OUTDCB 
LA 3,OUTAREA 
GWRITE (1),,(2),,(3),MF=E 


When expressing the "unit" operand in 
register notation, the value loaded into 
the register is the same as the UCB index 
(unit-1), and is placed in the high-order 
byte of the register. 


GCNTRL~-Erase Display Station Buffer 
Storage Macro Instruction 


The GCNTRL macro instruction erases data 
from the display station buffer storage. 
There are two possible erase operations 
performed by the GCNTRL macro instruction 
depending upon the “type™ operand speci- 
fied. The format of the GCNTRL macro 
instruction is: 


(ne Me ere ec ee ee eae ne 1 
| Operation|Operand 


| 
ee EAR neh Fa a PNR oeycee eee aE Saver Stil CE a ene oe ee 4 
|decb name | 
| | ,type | 
| |,dcb address | 
| | C,unit] | 
| [l MF={L| E}] | 
1 J 


decb name 
is the name assigned to the data event 
control block. This operand is re- 
quired for macro expansion. 


type 
specifies the type of control opera- 
tion. This operand is required for 
proper macro expansion. The following 
are the valid forms of the operand 
(each "type" is described following 
the discussion of all other operands 
related to the GCNTRL macro in- 
struction): 


ERS 
Erase Display Station Buffer Storage 
for the 2260. 

ERSW 
Erase Display Station Buffer Storage 
Without Keyboard Restore for the 2260. 


dcb address 
is the address of the data control 
block associated with the graphic 
device. 


unit 
| is a decimal integer; it is used to 
create an index to the desired element 
in the DEB table (address pointers to 
UCBS associated with the DCB). The 
indicated UCB contains the address of 
the desired device. The value of 
"unit" must be in the range 1 to N, 
where N is the number of devices spe- 
cified on the data definition card for 
this data set. N cannot exceed 25 
(the maximum configuration is 24 dis- 
play stations and one 1053 Printer per 
display control). 


Note: The device indicated by the 
"unit" operand cannot be the 1053 
printer, Since an erase operation is 
invalid for the 1053 printer. 


Omission of the "unit" operand 
results in a value of one being 
assigned to "unit", indicating the 
first element in the DEB table. If 
"unit" is incorrectly specified, an 
error message is printed on the 
assembly listing. 


MF=L 
specifies that expansion of the macro 
instruction is to consist of a parame- 
ter list only. The name assigned to 
the parameter list is the name speci- 
fied by the "decb name" operand of 
this GCNTRL L-form macro instruction. 


MF=E 
specifies the macro instruction is to 
perform the erase function using a pa- 
rameter list constructed by another 
GCNTRL macro instruction. The first 
operand in the E-form macro instruc- 
tion must correspond exactly to the 
name of the parameter list. The pa- 
rameter list may be updated at execu- 
tion time by specifying new values in 
any of the operands preceding the key- 
word operand. 


A "type" operand, specified in a L-form 
macro instruction, may be modified by a 
corresponding E-form macro instruction. 
Other operands required for execution that 
were not specified in an L-form macro 
instruction should be specified in the 
corresponding E-form macro instruction. 


Note: If neither the MF=L nor MF=E keyword 
operand is written, all required operands 
must be coded to achieve executable macro 
expansion. Omission of the "decb name" 
operand prevents macro expansion; omission 
of other operands produce error messages on 
the assembly listing, but do not terminate 
macro expansion. 


TYPES OF CONTROL OPERATIONS: The two types 
of control operations for the 2260 are 
described below. 


ERS (Erase Display Station Buffer Storage): 
This “type"™ operand causes the display sta- 


tion to delete all character data from the 
display station buffer storage. The cursor 
symbol is placed in the first display posi- 
tion of the CRT (upper left-hand corner), 
and the remainder of the display is blank. 


GCNTRL, “type" ERS, generates one chan- 
nel command word, the Erase Display Station 
Buffer Storage Control CCW, which initiates 
the erase operation. 


ERSW_ (Erase Display Station Buffer Storage 


Without Keyboard Restore): The operation 
caused by this "type" operand, which can 


only be used with IBM 2848 Models 21 and 
22, is identical to ERS, except that the 
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keyboard remains mechanically locked out at 
the completion of the operation. 


One channel command word is generated by 
GCNTRL, "“type™ ERSW: the Erase Display 
Station Buffer Storage Control Without Key- 
board Restore CCW, which initiates the 
erase operation. 


ERROR CONDITIONS: A normal completion is 
indicated by a hexadecimal code of 7F in 
the high order byte of the ECB (byte 0). 
If a permanent error occurs, a hexadecimal 
code of 41 is posted in this byte. 


After execution of the macro instruc- 
tion, the program should check the hexadec- 
imal return code in register 15 to 
determine whether execution was successful. 
Return codes and their meanings are: 


Return Code Meaning 

00 Normal 

10 DCB address is not in the DECB 

14 DCB addresses in the DECB and 
the IOB are not equal 

1c Type code is not in the DECB 

24 Area address is not in the 
DECB 

28 UCB addresses in the DECB and 
the DEB are not equal 

2C Unit index in the DECB exceeds 
units specified in the DD 
record 


Write-to-programmer messages are issued 
for the error conditions. For message 
explanations and programmer error checks, 


see IBM System/360 Operating System: Pro- 


blem Determination Aids and Messages and 
Codes for GPS and GSP, GC27-6970. 


EXAMPLES: In the coding below, a DECB 
named DECB1i is to be addressed. The "type" 
operand specifies that an ERS operation for 
the data set associated with the data con- 
trol block OUTDCB will be performed. The 
value of the “unit" operand is one. L-form 
is specified in Example 1. Example 2 shows 
coding for an L-form GCNTRL macro instruc- 
tion when positional operands are omitted. 
Example 3 shows coding for an E-form GCNTRL 
macro instruction when a positional operand 
is changed. 
EXAMP1 GCNTRL DECB1, ERS,OUTDCB,1, 
MF=L 


EXAMP2 GCNTRL DECB1,ERS ,MF=L 


EXAMP3 GCNTRL DECB1,,,4,MF=E 
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Register Notation: The programmer may 
specify register notation. In such cases, 


he must ioad the address of the DECB into 
register 1 before execution of the macro 
instruction. Other positional operands may 
be loaded into other registers (2-12). For 
example: 


EXAMP1 LA 1,DECB1 
GCNTRL (1) ,MF=E 
or 
EXAMP2 LA 1,DECB1 
LA 2,4 
SLL 2,24 
GCNTRL (1),,,(2) ,MF=E 


When expressing the "unit" operand in 
register notation, the value loaded into 
the register is the same as the UCB index 
(unit-1), and is placed in the high-order 
byte of the register. 


WAIT ~- Wait for One or More Events 


The WAIT macro instruction relinquishes 
control of the CPU when the problem program 
has no further processing to do and must 
wait for the completion of one or more 
input/output operations. For a complete 
description of the WAIT macro instruction, 


see IBM System/360 Operating System: 


Supervisor Services and Macro Instructions, 
GC28-6646. : 


aia Ne ee ge ee ee 1 
| Operation|Operand | 
| (number of events,] | 
Neo i { 
| \ECBLIST=address | 
1 


number of events 
maximum is 255. Zero is an effective 
NOP instruction; one iS assumed if the 
oeprand is omitted. The number of 
events must not exceed the number of 
event control blocks. 


ECB= 
is the address of the event control 
block representing the single event 
that must occur before processing can 
continue. Valid only if the number of 
events is one or is omitted. 


ECBLIST= 
is the address of a main storage area 
containing one or more consecutive 
fullwords on a fullword boundary. 
Each fullword contains the address of 
an event control block; the high-order 
bit in the last word must be set to 
one to indicate the end of the list. 
The number of event control blocks 
must be equal to or more than the 
specified number of events. 


PROGRAMMING NOTE: For the ECB post codes 
that report the completion status and 
result (that is, successful or with error) 
of an input/output operation, see IBM 


System/360 Operating System: Data Manage- 
ment for System Programmers, GC28-6550. 


CLOSE--Close Data Control Block Macro 
Instruction 


The CLOSE macro instruction disasso- 
ciates one or more data control blocks from 
the application program, thereby breaking 
the communication path between the applica- 
tion program and the display station. 

CLOSE performs the following functions: 


e Indicates that the DCB for the display 
Station is "closed" by setting the 
appropriate bit in the DCB. 


e Releases main storage acquired at open 
time, including the chain of IOBs and 
associated channel programs, as well as 
Storage acquired for attention handling 
functions. 


e Clears the fields in the DCB initial- 
ized at open time. 


e Deletes attention routines loaded by 
the "open" functions. (Basic attention 
handling only) : 


e Removes entries from the DCB address 
list (poll list) constructed at open 
time. (Express attention handling 
only) 


The format of the CLOSE macro instruc- 
tion is: 


be oe Pte ee cc cra ea ea 1 
| Name | Operation |Operand | 
}-------- }--------- }---------------------- i 
| (symbol) | CLOSE | (dcb address | 
| | {\C,,dcb address]...) | 
| | {{,MF={L|(E,parameter | 
| | | list name) | (E,(1))3] | 
bees Des see 5 (in ae ee ee eee ake ey 


dcb address 
Specifies the addresses of the DCBs 
for the graphic device(s) being 
closed. Any number of DCB addresses 
may be specified. If more than one 
DCB address is specified, the "dcb 
address" operands must be separated by 
two commas. The second comma indi- 
cates omission of an optional operand 
pertaining to volume disposition, as 


explained in IBM System/360 Operating 


System: Supervisor Services and Macro 
Instructions, GC28-6646. 


MF=L 
specifies that expansion of the macro 
instruction is to consist of a parame- 


ter list only. The name assigned to 
the parameter list is the name speci- 
fied in the Name field of this CLOSE 
macro instruction. 


MF=(E, parameter list name) 
specifies that the macro instruction 
is to perform the close functions 
using a parameter list constructed by 
another CLOSE macro instruction. The 
close function is executed for each 
"dcb address" operand in the list. 
"Parameter list name" must correspond 
exactly to the name specified in the 
Name field of the CLOSE macro instruc- 
tion used to construct the parameter 
list. 


MF= (E, (1)) 
performs the same function as (E, 
parameter list name). By writing the 
special register notation (1), the 
programmer signifies that he will load 
the address of the parameter list into 
register 1 before macro instruction 
execution. 


PROGRAMMING NOTES: If a task attempts to 
close a DCB that was not opened within the 
same task, the task is abnormally 
terminated. 


If the "dcb address" operand specifies a 
DCB that was already closed, no action 
results. If the operand does not specify 
the address of a DCB, the task is abnormal- 
ly terminated. 


Modifying the DECB at Execution Time 


Required parameters in the DECB may be 
modified at execution time by using an E- 
form macro instruction. The following pro- 
gramming considerations apply: 


1. Register notation may be specified. 
The register is loaded with the appro- 
priate parameter before execution of 
the macro instruction. 


2. In using register notation, registers 
2 through 12 may be used for operands 
other than the “decb name" operand. 
For this operand, register 1 must be 
used. 


3. If the “type" operand is changed, it 
should be specified only by using an 
E-form macro instruction containing 
the new "type" code. Register nota- 
tion is not allowed for the "“type" 
operand. 


Upon completion of an input/output 
operation, the completion flag in the event 
control block is set to one. If an ECB is 
used for more than one input/output opera- 
tion, it is the application programmer's 
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responsibility to set the completion flag 
to zero before execution of the second 
input/output operation and all subsequent 
input/output operations that refer to that 
ECB. The following illustration shows the 
position of the completion flag in the ECB. 


"hein aera ian | 
ECB { |11{ | | 
a! SN OE Gaerne Ree ese eee ae eR ER 


bits 0 1 2 31 


Assume, for example, that a data event 
control block named DECB1 is to be used for 
two read operations. The second GREAD 
macro instruction can be preceded by the 
following line of code to clear the comple- 
tion flag in the ECB. 


NI DECB1,X*BF' 


MVT Considerations 


The following rules apply to the use of 
input/output macro instructions in an MVT 
environment, where basic attention handling 
facilities are used. 
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e A graphic device that has been opened 


by one task must be closed by the same 
task. Any task attempting to open or 
close a device that has been opened by 
another task, and not subsequently 
closed, will be abnormally terminated. 
(Note that this applies to the graphic 
device, not the DCB.) 


e Within a single task, a graphic device 


may be opened more than once in succes- 
sion (that is, without being closed 
after each open). A different DCB must 
be used each time, however. 


A task may issue input/output macro 
instructions (GREAD, GWRITE, GCNTRL) 
for a DCB that has been opened by a 
subtask or by an originating task. 
However, if the task that opened the 
DCB closes the DCB before the input/ 
output function is completed, the task 
issuing the input/output macro instruc- 
tion may be abnormally terminated. 
Synchronization of open, close, and 
input/output functions is the applica- 
tion programmer's responsibility. 


The operator at the 2260 display station 
can present information to the system 
through a keyboard. Input from the key- 
board results in an attention (an unsched- 
uled input/output interruption). In order 
for such input to be meaningful, there must 
exist a routine or routines to be entered 
when an attention occurs. 


Under basic attention handling, the 
Input/Output Supervisor automatically 
detects the occurrence of an attention and 
routes control through control routines to 
the correct application program routine. 
The application programmer must supply 
information specifying which routine is 
available to handle an attention from a 
particular display station. The macro 
instructions described in this section pro- 
vide the necessary communication between 
the application program and the Input/ 
Output Supervisor. These macro instruc- 
tions give the programmer a high degree of 
control over the attention handling 
mechanism. The macro instructions and 
their functions are listed in Figure 7. 


FUNCTIONS OF BASIC ATTENTION HANDLING 


Basic attention handling provides the 
facilities to: 


e Detect the occurrence of attentions 
automatically. 


e Route these attentions to the applica- 
tion program attention handling 
routines. 


e Queue succeeding attentions, if neces- 
Sary, until the specified routine is 
ready to process them. 


So Ge a 

| Mnemonic | Macro Instruction Name 

Seiiecrea ies ees at Hee a a ee aS 

| SAEC | Specify Asynchronous Entry | 
| | Conditions | 
| | | 
|---------- }-----------------------------+ 
| SPAR | Specify Attention Routine | 
| | | 
}---------- }----~------------------------- 4 
| DAR | Delete Attention Routine | 
| | | 
[---------- }----------------------------- + 
| ATTNINQ | Attention Inquiry | 
| ( | 
boabecewee ce i ee ee 1 
Figure 7. Basic attention handling macro 
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BASIC ATTENTION HANDLING 


e Wait for expected attentions, optional- 
ly continuing selective processing in 
the meantime. 


Particular advantages of basic attention 
handling are: 


e Attentions are not lost if the routine 
designed to handle them is responding 
to an earlier attention at the time 
they are received. 


e Processing may be overlapped with 
attention input or operator response 
time or both. 


e System overhead is reduced, since there 
is no need to continually check for 
attentions. 


BACKGROUND INFORMATION 


The depression of the ENTER key on a 
2260 keyboard causes the control program to 
interrupt the currently processing routine 
(which may be an attention routine) and to 
determine which, if any, routine has been 
specified to handle attentions from that 
device. If an attention routine has not 
been specified, the attention data is lost 
and control returns to the application pro- 
gram. If an attention routine is avail- 
able, the attention data is placed in the 
programmer-Specified area (COMAREA), and 
the attention routine is given control. To 
be available for entry upon receipt of a 
2260 attention, a routine must have been 
designated by a SAEC macro instruction and 
the associated GACB must have been speci- 
fied by a SPAR macro instruction and not 
subsequently deleted by a DAR macro 
instruction. If the routine specified to 


as a a a a a a a a a a a i a 1 


Function | 

a la a ae Oo | 
Defines an attention handling routine and | 
specifies the exact conditions that will { 
cause entry to the routine. | 
Ss a a a gee ea J 
Makes attention handling routines available | 
for system use. | 
a eee ER AA ee TN EEN eee ar eee ae eee ee ea nen ee ree 4 
Makes attention handling routines unavail- | 
able for system use. { 
Fas AN we Ps ge ie PV ee ree II eR OT eee eae 4 
Allows communication between an attention | 
handling routine and the control program. | 
PnP LEER eee eta ae ean eI ae ly ee eee oe eee gee J 

instructions 
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process the attention is the routine in 
control, the attention data is held until 
the current processing is completed. 


Note: Issuing an attention from a 2260 
causes the keyboard on that 2260 to become 
inoperative. until the attention is pro- 
cessed either by an attention routine or by 
an ATTNINQ macro instruction. A GREAD or a 
GWRITE (not DATA ENTRY) macro instruction 
must be used to make the keyboard 
operative. 


BASIC ATTENTION HANDLING MACRO INSTRUCTIONS 


Macro instructions in this group allow 
the application programmer to define his 
program's attention handling capability to 
the system. The programmer can designate 
one attention handling routine to service 
attentions from all the graphic devices 
engaged in a task, or he can provide separ- 
ate routines for individual devices. The 
SAEC, SPAR, and DAR macro instructions are 
used to establish the status of his atten- 
tion handling routines. The ATTNINQ macro 
instruction is used to select an attention 
from a specified display station. 


SAEC--Specify Asynchronous Entry Conditions | 


Macro Instruction 


The SAEC macro instruction defines an 
attention handling routine by creating a 
parameter list called a graphic attention 
control block (GACB). The GACB contains 
information that identifies the attention 
handling routine, relates it to a 2260, 
specifies the entry point of the routine, 
and specifies the type or types of atten- 
tions that are to cause entry to the rou- 
tine. The GACB can be referred to subse- 
quently by the symbolic name of the SAEC 
macro instruction. The format of the SAEC 
macro instruction is: 


Name | Operation|Operand | 

| (symbo1] | SAEC | C(EP={entry point address |0}] | 
| €,DCB=dcb address] 

| | {,COMAREA=communication area address] | 

| | (, ATTNTYP={ ({A|S|R}, 2260) | SAVE| RESTORE} ] | 

| |€,MF={L|(E, gacb address) }] | 

Mates Scales a cc a a ag ime eae J 


Specifies the entry point of an atten- 
tion handling routine. If this 
operand is omitted or specified equal 
to zero (these are equivalent), any 
attention for the routine will be held 
but not processed, until such time as 
an entry point is supplied or until 
the attention is examined by the ATT- 
NINQ macro instruction. Subsequent 
attentions for this routine received 
from other 2260 stations are held 
until the first attention is 
processed. 
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Note: The 2848 display control locks the 
keyboard on the 2260 until the pending 
attention from that device is processed. 


DCB= 
Specifies the address of a DCB asso- 
ciated with the display station, or 
group of display stations, from which 
attentions are to be serviced. 


COMAREA= 
specifies the address of a programmer- 
defined area in main storage, aligned 
on a fullword boundary and at least 16 
bytes long, which is to be used by the 
control program to pass attention 
information to the attention routine. 


ATTNTY P= 
specifies the type of attention that 
will cause entry to the attention 
routine. # 


A, S, or R 
specify, respectively, whether the 
information that follows is to be 
added to or subtracted from or is to 
replace the existing ATTNTYP field in 
the GACB. If this operand is omitted 
from an E-form of the macro instruc- 
tion, R is assumed. 

2260 
specifies that the routine is to ser- 
vice attentions originating froma 
2260. 

SAVE, RESTORE 
specify, respectively, that the con- 
tents of the ATTNTYP field of the GACB 
are to be stored or are to be replaced 
with the mask saved by a previous SAEC 
macro instruction with an ATTNTYP=SAVE 
operand. 


Note: The codes A, S, R, SAVE, and RESTORE 
are provided for compatibility with other 
graphic devices, which may allow for more 
than one type of attention. 


MF=L 
specifies that the macro instruction 
is to construct a GACB utilizing the 
specified operands. Operands omitted 
from the L-form cause the associated 
fields to be set to zeros. If neither 
the L- nor E-form is specified, Lis 
assumed. A, S, R, SAVE, and RESTORE 
are not relevant when the L-form of 
this macro instruction is used. Omis- 
Sion of the A, S, or R operand need 
not be indicated with a comma. 


MF= 
causes the GACB established by an L- 
form of this macro instruction to be 
modified, as indicated by the other 
operands. If an operand is omitted, 
the corresponding field of the GACB is 


not affected. A comma must show the 
omission of the A, S, or R operand. 


PROGRAMMING NOTES: The values specified 
for the COMAREA, DCB, ATTNTYP, and EP 
operands of the SAEC macro instruction are 
inserted in the first, second, fourth, and 
fifth words of the GACB, respectively. All 
should have been defined and the DCB must 
have been opened before a SPAR macro 
instruction referring to this GACB is 
issued. 


The GACB, created by the SAEC macro 
instruction, is 14 words long. The first 5 
words of the GACB have the following 
format: 


ee. A (eee 
PY anaes aa.. | 
Peay oe | 

or eee a rare aaa 

116| ep address 


By setting the EP field of the GACB 
equal to zero, the programmer may queue 
attention data and process it in a back- 
ground routine (as opposed to an attention 
handling routine). All attention data for 
GACBsS with zero EP fields is placed on the 
Same queue. The attention data may be 
accessed when desired by means of the ATT- 
NINQ macro instruction. 


The EP field may be set to zero at 
assembly time (by means of the SAEC macro 
instruction) or at any time during execu- 
tion. If it is set to zero at execution 
time, any attentions received prior to set- 
ting EP equal to zero will be processed as 
described under "Background Infor- mation"; 
any received after EP has been set to zero 
will be queued. 


The first four words of the COMAREA have 
the following format: 


wn nn nn nnn nnd 


COMAREA +0] IX | RESERVED | TYPE | 
se inti ce lees 1—-—-———-————~—~—1-—-—~—-—-—~—~-—] 

+4| RESERVED | 
—-—-~—--——--—-—-—- ----——- —---—---- ---{| 

+8] RESERVED | 

Bi a a tS se os a i i as a al acre at ne pe casita | 

+12] RESERVED | 


| PROGRAMMER-DEFINED AREA | 


Field 
RESERVED 


Contents 
These fields are used by the con- 
trol program. 


IX If multiple 2260s are assigned to 
a Single DCB, this byte is set to 
an integer from 1 through 25 to 
indicate which device originated 
the attention that the routine 
has currently available for pro- 
cessing. The value of IX corre- 
sponds to the position of the 
device in the device list sup- 
plied by the DD card and placed 
in the DEB by an OPEN macro 
instruction. (IX functions in 
the same manner as the “unit" 
operand of the GREAD, GWRITE, and 
GCNTRL macro instructions.) If 
one 2260 is assigned to a single 
DCB, the byte is set to zero 
(hexadecimal 00). 

TYPE This is always a hexadecimal 07, 

Signifying a 2260 attention. 


The user may add other fields to the 
COMAREA; see the suggestion under “Applica- 
tion Program Attention Handling Routine." 


If an attention routine is to serve more 
than one device, and these devices have 
been specified in separate SAEC macro 
instructions, its executable code must be 
reenterable. 


The DCB address in a GACB should not be 
changed without first deleting the atten- 
tion routine with a DAR macro instruction. 
After changing the DCB address, the routine 
must be respecified with a SPAR macro 
instruction. 


EXAMPLES: 


GACBX1 SAEC EP=AR1,DCB=GRAPHD1, 
ATTNTYP=2260, 
COMAREA=AREA1 


The GACB established by this macro 
instruction can be referred to by the sym- 
bol GACBX1. The GACB defines an attention 
routine whose entry point is AR1. This 
routine is able to service attentions from 
the 2260 display station or stations asso- 
Ciated with the identified DCB, and it will 
receive attention information in the COM- 
AREA identified by the symbol AREA1. 
Because the macro-form (MF) is not speci- 
fied, L-form is assumed. 


EX2 SAEC DCB=GRPHDCB2, EP=(3), 
MF= (E, GACBX1) 


This macro instruction changes the DCB 
address and the attention routine entry 
point in the GACB defined in the first 
example. 
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Note: If this routine has been previously 
specified (with a SPAR macro instruction), 
it must be deleted (with a DAR macro 
instruction) before changing the DCB 
address. After issuing the SAEC macro 
instruction to change the DCB address, the 
attention routine must then be respecified 
before it is available to the system. 


SPAR--Specify Attention Routine Macro 
Instruction 


The SPAR macro instruction makes pre- 
viously defined attention handling routines 
available for system use by establishing 
control program references to their GACBs. 
It also assigns priority if multiple atten- 
tion routines are defined. The format of 
the SPAR macro instruction is: 


Renee We pee ee. a RP eee G ee Sete 8 ee ee OR Teag 7 


| Name | Operation|Operand | 
|--------4---------}---------------------- { 
| [Symbol] | SPAR | (gacb address | 
| | {| {,gacb address]...) | 
| | | l, PRTY=integer] | 
| | {(,MF={L|(E,gacb list | 
| | { address) }] | 
RR a eee ee hs ra we Sr eee ae are 4 


gacb address 
Specifies the address of a graphic 
attention control block (GACB), de- 
fined by a SAEC macro instruction, 
that is to be made available to the 
system. 


PRTY= 
is a decimal integer from 0 through 
127, used to determine priority among 
attention routines. Priority in- 
creases with numeric value (127 gives 
highest priority). No attention 
handling routine may have control 
while a higher- priority routine for 
the same device has any processing to 
do. | 


MF=L 
Specifies the construction of a list 
of GACB addresses that can be used by 
an E-form of either a SPAR or DAR 
Macro instruction. 


MF=E 
specifies that the list of GACBs 
referred to by the “gacb list address" 
operand is to be modified as indicated 
by the “gacb address" operands and 
that the GACBs in the list are then to 
be specified, that is, made available 
for system use. The list cannot be 
lengthened or shortened by the E-form 
of this macro instruction. 


gacb list address 
specifies the address of a list of 
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PROGRAMMING NOTES: 


GACBs established by an L-form SPAR 
Iacro instruction. 


The PRTY operand is 
provided primarily for compatibility with 
certain other graphic devices that are cap- 
able of originating more than one type of 
attention. For such devices, the PRTY 
operand permits a routine designed to 
handle attentions of a particular type to 
interrupt another, less important, atten- 
tion routine that handles attentions of 
another type from the same device. The 
programmer establishes the relative “impor- 
tance" of routines for this purpose by use 
of the PRTY operand. This usage is not 
possible on the 2260, which can originate 
only a single type of attention. There- 
fore, the PRTY operand can normally be 
omitted. 


When the PRTY operand is omitted, a 
priority of zero is assigned. 


If more than one attention routine is 
available for any one 2260 at any time, and 
if these routines have been assigned the 
Same numeric priority (for example, by 
omission of the PRTY operand), the routine 
referred to last in the last SPAR macro 
instruction has the highest priority. 


All attention handling routines take 
precedence over any background routine. 


An attention routine may be interrupted 
and immediately reentered if the same rou- 
tine is defined in separate SPAR macro 
instructions for two or more display sta- 
tions or if the routine is used by more 
than one task. Such a routine must be 
reenterable (that is, it must not modify 
itself in any way). 


If the same GACB is referred to more 
than once in a SPAR macro instruction, 
references after the first are treated as 
no-operations. A GACB address of zero, in 
a list of GACB addresses, will also be 
treated as a no-operation. 


ERROR CONDITIONS: Certain error conditions 
will stop the processing of a list of GACBs 
and cause an immediate return. Upon return 
to the program, register 1 will contain the 
address of the GACB associated with the 
error condition, and register 15 will con- 
tain one of the following return codes to 
indicate the type of error: 


Return Code Meaning 
04 DCB is not a graphics DCB 
os GACB was already specified 
through a SPAR macro 
instruction 


OC Parameter list is too short to 
contain GACB addresses 


10 DCB is not open 


14 (MVT only) SPAR macro instruc— 
tion is not issued by the task 
that opened the DCB 


Write-to-programmer messages are issued 
for the error conditions. For message 
explanations and programmer error checks, 


see IBM System/360 Operating System: Pro- 


blem Determination Aids and Messages and 
Codes for GPS and GSP, GC27-6970. 


EXAMPLES: 


EX1 SPAR (GACBX2) 

This macro instruction establishes con- 
trol references to the routine defined in a 
GACB identified by GACBX2. 

EX2 SPAR (GACBX1, NAME3, TAG6) , MF=L 

This macro instruction constructs a list 
containing the three GACB addresses 
specified. 
EX3 SPAR (, ,GACBX3) , MF=(E, EX2) 

This macro instruction causes the param- 
eter list constructed by ExXz to be modi- 
fied, replacing the third GACB address 
(TAG6) with GACBX3. Control references are 
then established for the three GACBs 
referred to by the list. 


DAR--Delete Attention Routine Macro 
Instruction 


The DAR macro instruction is the inverse 
of the SPAR macro instruction. It makes 
attention handling routines unavailable for 
System use by deleting the control program 
references to the GACBs established by 


SPAR. The format of the DAR macro instruc- 
tion is: 

ooo re te ae ee 1 
| Name | Operation | Operand | 


(,MF={L| (E, 


| 
| 
gacb list | 
address) }] | 


gacb address 
Specifies the address of a GACB defin- 
ing the attention handling routine to 
be deleted. 


MF=-L 
Specifies formation of a list of the 
GACB addresses written in the macro 
instruction. 


MF=E 
specifies that the list of GACBs 
referred to by the “gacb list address" 
operand is to be modified by the “gacb 
address" operands and that all atten- 
tion routines referred to in the list 
are then to be deleted, that is, made 
unavailable for system use. 


gacb list address 
Specifies the address of a list of 
GACB addresses constructed by an L- 
form SPAR or DAR macro instruction. 


PROGRAMMING NOTES: The CLOSE function will 
delete all attention routines defined for 
the associated DCB. However, an attempt to 
issue a CLOSE macro instruction from an 
attention routine will result in abnormal 
termination of the task. Similarly, an 
attempt to delete an active attention rou- 
tine will result in an error condition. 


ERROR CONDITIONS: Certain error conditions 
will stop the processing of a list of GACBs 
(or of one GACB) and cause an immediate 
return. Upon return to the progran, 
register 1 will contain the address of the 
GACB associated with the error condition, 
and register 15 will contain a return code 
to identify the error condition as follows: 


Return Code Meaning 
04 DCB address is not in the GACB 
08 GACB was not specified through 


a SPAR macro instruction 


Oc Parameter list is too short to 
contain GACB addresses 


10 Specified attention handling 
routine is still active 


14 (MVT only) DAR macro instruc- 
tion is not issued by the task 
that issued the SPAR macro 


instruction 
18 DCB is not open 
1c DCB is not a graphics DCB 
20 Attention handling environment 


is not basic 


Write-to-programmer messages are issued 
for the error conditions. For message 
explanations and programmer error checks, 
see IBM System/360 Operating System: Pro- 


blem Determination Aids and Messages and 
Codes for GPS and GSP, GC27-6970. 


ATTNINQ -- Attention Inguiry Macro 


Instruction 


The ATTNINQ macro instruction estab- 
lishes communication between an attention 
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handling routine and the control program to 
permit the routine to select an attention 
from a specified display station or from 
any display station. This allows the 
attention handling routine to wait until 
the attention occurs, to relinquish control 
to the mainline program until the attention 
occurs, to branch to a specified address if 
specified attention information is pending, 
or to clear all attentions pending for this 
routine. In the case of CLEAR, the atten- 
tions are released, but the 2260 display 
station must be manually unlatched. The 
format of the ATTNINQ macro instruction is: 


| Operation | Operand | 
~-~-~-=~}---------}------------------------------------] 


| [symbol] |ATTNINQ |gacb address, | 
| | | MODE={R|W|[(C,branch address) |CLEAR} | 
| | | (, UNIT={int eger | ALL} ] | 
| | | (€,MF={L|(E, parameter list address) }] | 
beoeted fea eat a aad SS ea eae Sed J 
gacb address 

Specifies the address of the asso- 

ciated GACB. 


MODE= 
Specifies one of the four modes of 
inguiry, as follows: 


R 
relinguish mode. The attention handl- 
ing routine is to relinguish control 
until attention information from the 
display station the routine is servic- 
ing (specified by the UNIT operand) is 
available for that routine. When this 
information is available, processing 
resumes with the next sequential 
instruction. This mode is treated by 
the system as a W (wait) mode if the 
ATTNINQO macro instruction is issued 
from a routine entered by means of a 
LINK macro instruction, or if the EP 
field of an associated GACB has been 
set to zero. 

W 
wait mode. The attention handling 
routine is to be placed in a wait 
State until attention information is 
available from the display station 
specified by the UNIT operand. While 
the attention routine is in a wait 
state, attentions from other display 
Stations can be serviced by other 
attention routines or another task can 
be in control. When the wait condi- 
tion is satisfied, and control is 
returned to the attention routine, 
processing continues with the next 
sequential instruction. 

C,branch address 
condition mode. If attention informa- 
tion from the device specified by the 
UNIT operand is presently pending for 
processing by this attention handling 
routine, a branch is made to the loca- 
tion specified by the “branch address" 
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operand. Otherwise, processing con- 
tinues with the next sequential 
instruction. 

CLEAR 
clear mode. All attentions pending 
for this attention handling routine 
are released, and processing continues 
with the next sequential instruction. 
The keyboard on any 2260 display sta- 
tion must be manually unlatched if an 
attention issued by it has been 
cleared by an ATTNINQ macro 
instruction. 


UNIT=integer 
specifies a decimal integer from 1 
through 25 and corresponds to the 
position of the device in the device 
list supplied by a DD statement, where 
multiple devices are assigned to a 
Single DCB. It is used as an index to 
select one of the several UCB 
addresses appended to the data extent 
block (DEB). The index value corres- 
ponding to the 1053 printer may not be 
specified. (This operand functions in 
the same manner as the "unit" operand 
of the GREAD and GWRITE macro 
instructions.) 


UNIT=ALL 
specifies that an attention will be 
accepted from any 2260 assigned to the 
DCB. 


If the UNIT operand is omitted, ALL 
is assumed. 


MF=L 
specifies that the expansion of the 
macro instruction is to consist of a 
parameter list only. The symbol writ- 
ten in the Name field is assigned to 
the parameter list. 


MF=E 
causes the parameter list, established 
by the L-form of the macro instruction 
and identified by the parameter list 
address operand, to be modified by the 
preceding operands and causes the 
attention inquiry request to be 
executed. 


parameter list address 
specifies the address of a parameter 
list established by an L-form ATTNINQ 
macro instruction. 


PROGRAMMING NOTES: The ATTNINQ macro 
instruction may be issued within an atten- 
tion routine or, if the EP field of the 
associated GACB is set to zero, may be 
issued from a background routine. Standard 
register conventions must be observed (see 
IBM System/360 Operating System: Supervi- 
sor Services and Macro Instructions, 
GC28-6646). 


The UNIT operand must be used in con- 
junction with the W or C mode if there are 
multiple devices for the associated DCB. 
It is meaningless in conjunction with the 
CLEAR or R mode. 


Under R, W, or C mode, information per- 
taining to the attention that satisfies the 
inquiry is made available in the COMAREA. 


ERROR CONDITIONS: During execution, cer- 
tain error conditions will terminate pro- 
cessing of the ATTNINQ macro instruction 
and cause an immediate return to the pro- 
gram. Upon return, register 15 contains a 
return code to identify the error condition 
as follows: 


Return Code Meaning 
10 Parameter list contains no 
GACS3B address 


14 EP2 field of the GACB is not 
ZeELO 
18 GACB was not specified through 


a SPAR macro instruction 


1C (MVT only) ATTNINQ macro 
instruction is not issued by 
the task that issued the SPAR 
macro instruction 


20 Mode field in the parameter 
list is invalid 

24 Internal dequeue error 
occurred 

28 Specified attention handling 
routine is already in a wait 
state 

2C Branch address is not in the 


parameter list 


Write-to-programmer messages are issued 
for the error conditions. For message 
explanations and programmer error checks, 


see IBM System/360 Operating System: Pro- 


blem Determination Aids and Messages and 
Codes for GPS and GSP, GC27-6970. 


EXAMPLES : 
EX1 ATTNINQO GACBX4,MODE=R 


This macro instruction causes control by 
the attention routine to be relinquished 
until the desired attention occurs. 


EX2 ATTNINQ GACBX4, MODE=W, UNIT=5 


This macro instruction causes the task 
to enter a WAIT state until attention 
information from the display station which 
occupies the fifth position on the device 
list is available. 


EX3 ATTNINQ GACBX4,MODE=(C,BRANCHA) , 
UNIT=5 


This macro instruction causes a branch 
to be taken to location BRANCHA if an 
attention from the display station which 
occupies the fifth position on the devices 
list is pending. 


EX4 ATTNINQ GACBX4 ,MODE=CLEAR 


This macro instruction causes all atten- 
tions pending for this routine to be 
released. 


APPLICATION PROGRAM ATTENTION HANDLING 
ROUTINE 


The following notes may be helpful to an 
application programmer writing a program 
designed for operator-machine 
communication. 


ESTABLISHING THE ATTENTION ROUTINE 


An attention handling routine is defined 
by means of a SAEC macro instruction, which 
establishes a graphic attention control 
block (GACB) containing the information 
provided in the SAEC macro instruction. In 
the GACB are: 


1. The address of the entry point of the 
associated attention routine. 


2. The address of a DCB associated with 
the device to be serviced. 


3. The address of a communication area 
(COMAREA) to be used to pass attention 
information to the attention routine. 


The GACB thus provides a link between a 
display station or group of display sta- 
tions and an attention routine. 


Although defined, an attention routine 
is not available for use until it has been 
"Specified" by means of a SPAR macro 
instruction. This establishes control pro- 
gram references to it. 


The DAR macro instruction can be used to 
disable an attention routine that is no 
longer needed, although the associated DCB 
remains open. The SPAR and DAR macro 
instructions may be thought of as analogous 
to OPEN and CLOSE. 


PROCESSING THE ATTENTION 
Upon entry to an attention handling rou- 
tine, register 1 contains the address of 


the GACB. In the first word of the GACB is 
the address of the communication area, or 
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COMAREA. If more than one device is 
assigned to the DCB, the first byte of the 
COMAREA indicates the device that origina- 
ted the attention. 


Use of the communication area allows the 
programmer to pass information between the 
housekeeping/background routine and the 
attention routine or routines. Each dis- 
play station may be associated with its own 
communication area, and the attention data 
for each display station may be recorded 
independently of that for other display 
units. One of the fields in the communica- 
tion area can be an ECB where completion of 
attention processing can be posted. The 
attention routine can post the appropriate 
ECB when it completes attention processing 
for that display station. 


Using the information available in the 
COMAREA and.the DCB, the attention handling 
routine can perform necessary calculations, 
issue appropriate input/output commands, 
and do whatever else is required to respond 
to the attention. If further communication 
from the display station operator is 
required, an ATTNINQ macro instruction can 
be used to relinquish control or enter a 
wait state until the desired attention 
occurs, or to set up a conditional branch 
based on its availability. 


When processing of the last attention of 
a communication sequence has been com- 
pleted, attentions (for this routine) can 
be cleared by means of an ATTNINQ, mode 
CLEAR, macro instruction before passing 
control to the interrupted routine by means 
of the RETURN macro instruction. 


The following is a brief outline of 
functions that might be performed by a 
housekeeping/background routine and by an 
attention handling routine. 


Housekeeping/Background Routine 


1. Open the DCB for the display station 
or stations. 


2. Establish the attention routine by 
means of the SAEC and SPAR macro 
instructions. 


3. Issue input/output commands. 


4. Make sure that input/output operations 
were Started successfully. 


5. Wait for posting of completion in the 
ECB or perform background processing, 
which may or may not be related to the 
attention routine. 
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6. Close the DCB. 


7. Indicate task completion by issuing 
the RETURN macro instruction. 


Attention Routine 


1. Perform standard entry functions: 
save registers, establish addressabil- 
ity, etc. 


2. Perform operations based on the atten- 
tion information. 


3. Issue input/output commands. 


4. Make sure that input/output operations 
were started successfully. 


5. Wait for the next attention by means 
of the ATTNINQ macro instruction. 


6. After the last attention is serviced, 
post completion in the ECB and return 
control to the background routine by 
means of the POST and RETURN system 
macro instructions. 


SYNCHRONIZING THE APPLICATION PROGRAM 
ROUTINES 


Synchronization of the housekeeping/ 
background routine and the attention handl- 
ing routine is the application programmer's 
responsibility. He may use the WAIT system 
macro instruction to delay execution of the 
housekeeping/background routine until com- 
pletion has been posted in an ECB by the 
application program attention routine. The 
attention routine may either explicitly 
post the ECB by means of the POST system 
macro instruction or, by means of an appli- 
cation program convention, locate the 
appropriate ECB by means of the graphic 
attention control block and then post com- 
pletion. The attention routine passes con- 
trol back to the housekeeping/background 
routine by means of the RETURN macro 
instruction. Since completion has been 
posted, the housekeeping routine is taken 
out of its wait state, and execution con- 
tinues. This cycle, the passing of control 
to the attention routine when an attention 
occurs and the returning of control to the 
interrupted (housekeeping/background) rou- 
tine when completion is posted, continues 
as long as the attention routine is defined 
and as long as attentions occur. 


MVI. CONSIDERATIONS 


The following rules apply to the use of 
basic attention handling facilities in an 
MVT environment. 


e In order for the application program 


attention handling routines to be 
available to a device, they must be 
defined (by means of an SAEC macro 
instruction) and specified (by a SPAR 
macro instruction) within the task that 
opens that device or within one of its 
subtasks. A SPAR macro instruction 
issued from an inappropriate task will 
return with a return code of hexadecim- 
al 14. 


Each GACB must be deleted (by means of 
DAR) by the task in which it was speci- 
fied (by SPAR). A DAR macro instruc- 
tion from another task will cause a 
return with a return code of hexadecim- 
al 14. An attempt by one task to close 
a DCB for which one or more GACBS are 
Still specified by another task will 


result in the abnormal termination of 
the specifying task. 


An ATTNINQ macro instruction for any 
GACB may be issued only by the task 
that specified (by means of SPAR) that 
GACB; otherwise, the ATTNINO macro 
instruction returns control with a 
return code of hexadecimal 1C. 


An application program attention rou- 
tine may serve more than one task. 
However, a Separate GACB must be estab- 
lished for each task-device-routine 
combination. The application programm- 
er is responsible for ensuring that the 
task containing the attention routine 
is not terminated while other tasks 
have active (currently specified) GACBs 
referring to that routine. 
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APPENDIX A: SAMPLE PROGRAM 


Coding shown in Figure 8 is intended for 
use with two IBM 2260 Display Stations 
(Local Attachment), equipped with the 
alphameric keyboard feature. A 1053 print- 
er is not needed. 


For the purposes of this sample program, 
it is assumed that the first seven charac- 
ters of the manual input message contain a 
code (‘'PROCESS') that determines whether 
the routine processes the message and 
stores the results or, in the absence of 
the code, ends the job and displays results 
derived from the processing of each indivi- 
dual request. 


The purpose of each element of the pro- 
gram is explained by the comments in the 
illustration. The following paragraphs 
note several graphic programming considera- 
tions illustrated by the program. 


Opening the DCB: The DCB for the 2260s 
must be opened before references are made 
to it. 


Use of the GREAD Macro Instruction: The 
GREAD macro instruction shown in the codin 
generates a Read Display Station Manual 
Input (DSM) operation. 


Use of the GWRITE Macro Instruction: The 
GWRITE macro instruction shown issues an 
Erase and Write Display Station Buffer 
Storage (EBW) operation to clear the 
storage and write a message to the 
operator. 


Use of the Basic Attention Handling Facili- 
ties: Ail application program attention 


handling routines should consider them- 
selves as subroutines, and as such, stan- 
dard subroutine linkage should be observed. 
The COMAREA shouid be saved if there is an; 
possibility that the attention routine pre- 
sently in control may be interrupted durin 
execution by another attention routine that 
Shares the same COMAREA. 
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APPENDIX B: CCW'S ASSOCIATED WITH INPUT/OUTPUT CONTROL 


The following are formats of CCWs generated when GREAD, GWRITE, and GCNTRL macro 
instructions are used. 


GREAD DSM CCW FORMAT 


Command Data Byte 

Code Address Flags* Count 
ran ie Moy See yeas Renan Ve ee ee ee ee ee 1 
| 02 | rf ft ¢f— tT tT | | 
boca Do a ete f SSkemenele lemceneren a apn yeeny (mayan! Lennie! mena an etreyrn ve See SEEPS are EN SRE ee OnNeE EA Een EOE ISD J 
0 7 8 31 32 33 34 35 36 48 63 


Command Data Byte 

Code Address Flags* Count 
ee ea ee co Ri ee eo ee ee ee og ee eer aes 1 
{ 12 | | | | | | | | | 
Usa ies eee asi ey B Ranger) Sane i Eeaeeyees Sma eeeey Demeae Le er ee ee en ee Xena eee ale ay ege Renan ee J 
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GREAD SMI CCW FORMAT 


Command Data Byte 

Code Address Flags* Count 
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Command Data Byte 

Code Address Flags* Count 
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| 1a | | | | | | | | | 
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Command Data Byte 
Code Address Fliags* | Count 
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| 06 | f |J2.i | | | | 0002 | 
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Command Data Byte 
Code Address Flags* Count 
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bow eoe i gee ng are ne So H Seep AL eoe LORMAN Mer Reiter Wien ON MDREE enna RR Savee eae 5 Ee ee ae eye a On J 
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Bit 33 -- chain command flag 
Bit 34 -- suppress length indication flag 
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GREAD DSBW CCW FORMATS 


Command Data Byte 
Code Address Flags* Count 
Gon et ep eo eo og ee ee Wr re ene ee 1 
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Command Data Byte 
Code Address Flags* Count 
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GWRITE DSB CCW FORMAT 
Command Data Byte 
Code Address Flags* Count 
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GWRITE DSBW CCW FORMAT 
Command Data Byte 
Code Address Flags* Count 
fe eee ee ee ey fe re oe Pr ee 1 
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Command Data Byte 
Code Address Flags* Count 
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GWRITE EBWW CCW FORMATS 
Command Data Byte 
Code Address Flags* Count 
perce sea ei ee ae re ee a ge ee 1 
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Command Data Byte 
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Bit 33 -- chain command flag 
Bit 34 -- suppress length indication flag 
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GWRITE LNE CCW FORMAT 


Command Data Byte 
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een Qa a eo gn OR ey en re 
| O05 | tf | E12 | | | | 
Disses te. fl pee nape eee ree Renee Comyn Semmes ERIS) Ceseeeree! Darya ter) Sey meye ey net epee ee snack yan see aed ee are eee eee a J 
0 7 8 31 32 33 34 35 36 4g 63 


GWRITE LNEW CCW FORMAT 
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GWRITE EWL CCW FORMATS 


Command Data Byte 

Code Address Flags* Count 
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. re et ee ee mae ara Wi eh eg pe ne ere 1 
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GWRITE EWLW CCW FORMATS 

Command Data Byte 

Code .§ Address Flags* Count 
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Command Data Byte 

Code Address Flags* Count 
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GCNTRL ERS CCW FORMAT 


Command Data. Byte 

Code Address Flags* Count 
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GCNTRL ERSW CCW FORMAT 
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Bit 33 -- chain command flag 
Bit 34 -- suppress length indication flag 


The operator at the 2260 display station 
can present information to the system 
through a keyboard. Keyboard input results 
in an attention interruption. Express 
attention handling requires that the appli- 
cation program check for the occurrence of 
an attention. When an attention is 
detected, attention information is routed 
to the appropriate application program 
attention handling routine. 


Macro instructions are provided to com- 
municate the occurrence of attentions to 
the application program. The macro 
instructions and their functions are listed 
in Figure 9. 


BACKGROUND INFORMATION 


When an attention from a 2260 occurs, 
the application program is interrupted and 
control goes to the control program. The 
control program sets a bit in the graphic 
control byte (GCB) associated with the dis- 
play unit from which the attention was 
received. Control then returns to the app- 
lication program at the point of 
interruption. 


To determine whether or not an attention 
has occurred, the application program must 
include an attention analysis provision to 
periodically inspect the bits in the GCBs. 
This attention analysis can be done by 
using either the ANALYZ macro instruction 
Or a programmer-written substitute. If the 
application programmer elects to perform 
his own attention analysis, he must employ 
the GSERV macro instruction to reset bits 


APPENDIX C: EXPRESS ATTENTION HANDLING 


EXPRESS ATTENTION HANDLING MACRO 
INSTRUCTIONS 


The macro instructions in this group are 
provided to help the application programmer 
service attentions from the 2260. 


ANALYZ—--Graphic Attention Analysis Macro 
Instruction 


The ANALYZ macro instruction performs 
attention analysis to determine the occur- 
rence of and the reason for an attention 
from a keyboard entry on the 2260. This is 
done by a polling technique that inspects 
the bits in the GCBs. The ANALYZ macro in- 
struction also resets the GCB (by calling 
on the GSERV macro instruction), places 
coded information into an output area 
defined by the application programmer, and 
gives control to the appropriate applica- 
tion program routine to handle the 
attention. 


To employ the ANALYZ macro instruction, 
the application programmer must: 


1- Include the ANALYZ macro instruction 
statement in his application program. 


2. Provide a contiguous list of DCB 
addresses and UCB index factors that 
indicate the UCB containing the appro- 
priate GCB from which an attention is 
possible. This list is provided at 
open time if the POLST operand is spe- 
cified in the DCB macro instruction. 


3. Specify the entry address of the rou- 
tine to handle the keyboard attention. 


4. Reserve eight bytes (beginning ona 
fullword boundary) in his program area 
into which the output of ANALYZ can be 


in the GCBs. placed. 

ar aaa ee eee ee ETS Ga eR OR IS AL 8 EO OE ee gp PE ee ee 1 
{ | Macro Instruction | | 
| Mnemonic | Name | Function — | 
|---------- ~-------------------- |~----------------------------------------------------- { 
| ANALYZ | Graphic Attention | Determines and analyzes the occurrence of an atten- | 
[ | Analysis | tion from a display station. The bits in the GCB | 
| | {| are reset before control is given to an application | 
| | | program routine to handle the attention. | 
|~--------- }--------------------- |{------------------------------------------------------ { 
| GSERV | Graphic Attention {| Resets the bits in the GCBs associated with atten- | 
| | Service {| tions. This macro instruction must be employed if | 
| | {| an application programmer elects to perform his own (| 
| | | attention analysis instead of using ANALYZ. | 
Bi ee ea Meee eee Area a i NOR et epee Ne oe ers ener eee me A ee eae er a ie amen en ee we a a J 


Figure 9. 


Express attention handling macro instructions 
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The format of the ANALYZ macro instruction 


a ea 
| Name [operation |Operand | 
=== S=> Sp ee 
| [Symbol] | ANALYZ |polst address, | 
| { {pointer address [ 
| | [(,MF={L|(E,parameter | 
i | { list name)|(E,(n))}] | 
 eaeaeiopceae ce emer Eanes este eee Pa Tage a Pe J 


polst address 
is the address of a 4-byte reserved 
area followed by a list of DCB 
addresses and UCB index factors that 
indicate the UCB containing the appro- 
priate GCB. Each is aligned on a ful- 
lword boundary. The reserved area is 
used by ANALYZ to point to the last 
DCB address in the list. The list is 
constructed at open time if the POLST 
operand is specified in the DCB macro 


instruction. The format of the list 
is: 
SS faa el ee ‘ 
polst iReserved Area | 
}------7--------------------- { 
{UCB | DCB | 
{Index | Address ] 
~-~--- }---------------------| 
[UCB | DCB | 
{Index | Address | 
pb | 
| | 


pointer address 

is the symbolic address of the first 
word of a 5-word field located ona 
fullword boundary in the application 
program area. The contents of the 
field are shown in Figure 10. 


Note: The application programmer must 
insert zeros in three of the five words 
indicated in Figure 10. Word two of the 
pointer table must contain a valid routine 
address if either optional keyboard feature 
is used. 


a 
| 
| 
| 
| 
| 
| 
| 
| 
| 
I 
| 
! 
| 
| 
i 
| 
| 
| 
| 
| 
! 
i 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 

= 


| Word | Contents | | 
}------ }---------------------------------- { 
j; 1 { (Not used. Programmer must spe- | 
| | cify zeros.) | : | 
{| 2 | Address of the application pro- | 
| | gram Keyboard Attention routine. | 
| 3 | (Not used. Programmer must Spe- | 
| | cify zeros.) | | 
| 4 {| (Not used. Programmer must spe- | 
| | cify zeros.) | 
| 5 {| Address of the first byte in the | 
{; | output area (see "Output" | 
| {| below). hos | 
I a Pe se ed 
Figure 10. Contents of the pointer table 
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OPERAND FORM: 


ERROR: CONDITIONS: 
address" 


OUTPUT:.- 


MF=L 
specifies that expansion of the macro 
instruction is to consist of a parame- 
ter list only. The name of the param- 
eter list is the symbolic name speci- 
fied in the "Name" field of this ANA- 
LYZ macro instruction. The “polst" 
and "pointer" operands may only be 
written as relocatable expressions. 


MF=(E, parameter list name) 
specifies that the macro instruction 
is to perform the ANALYZ functions 
using a parameter list constructed by 
another ANALYZ macro instruction. The 
"parameter list name" operand must 
correspond exactly to the name of the 
parameter list. 


MF=(E, (n)) 
performs the same function as (E, 
parameter list name). By writing 
register notation (in the range 2 
through 12), the programmer signifies 
that he will load the address of the 
parameter list into the indicated 
register before the macro instruction 
is executed. 


The following are the allow- 
able operand forms for the ANALYZ macro 
instruction. 


1. If the MF keyword operand is omitted 
or specified as L, the "polst address" 
and “pointer address" operands must be 
written as relocatable expressions. 


2. If the MF=E keyword operand is speci- 
fied, the “polst address", "pointer 
address", and "parameter list name" 
operands can be written as relocatable 
expressions; as implied or explicit, 
indexed or nonindexed addresses; or in 
negueter notation. For caenp ee. 


LISTNAME ~ANALYZ POLST, POINTER, MF=L 


ANAYLZ POLST1,MF=(E, LISTNAME) 
Or 

LA - 2,POLST1 

LA 3, LISTNAME 

ANALYZ (2),MF=(E, (3)) 


If either the “"polst 

or "pointer address" operand is 
missing at assembly time, a message is 
printed on the assembly listing indicating 


the omission, and macro generation con- 


tinues. If either parameter is missing, 


the macro instruction does not perform its 


intended function. 


The output of the ANALYZ macro 

instruction is placed in an 8-byte output 
area whose address is in word five of the 
pointer table. This area must begin ona 
fullword boundary. Output consists of the 


following, in the order listed: 


e Reserved (four bytes) 
e UCB address index factor (one byte) 
e Address of DCB (three bytes) 


ROUTINE EXITS: If inspection of the DCB 
list finds no attention indication, a code 
of hexadecimal 04 is placed in the return 
code register, and control is returned to 
the next sequential instruction in the app- 
lication program. If an attention is 
detected, the macro instruction determines 
the address of the DCB, resets the GCB, 
stores output data in the output area, and 
gives control to the appropriate applica- 
tion program attention handling routine 
with the address of the output area in 
register 1 and the return address in 
register 14. The application programmer 
must save and restore registers in his 
attention handling routine. 


Note that the application program atten- 
tion handling routine, upon completion, 
does not return control to ANALYZ. Control 
may be returned from the attention handling 
routine to the next sequential instruction 
after ANALYZ by use of the RETURN macro 
instruction. 


When ANALYZ is executed, it starts ini- 
tially at the top of the poll list; but 
after the initial keyboard attention has 
been processed, starts at the point of pre- 
vious exit from the poll list. 


A return to the application program next 
sequential instruction is made (1) if no 
attention occurred, or (2) if the address 
of a 2260 keyboard attention routine is not 
provided in word two of the pointer table, 
or (3) if the address of an output area is 
not provided in word five of the pointer 
table. The attention is lost if no key- 
board attention routine is provided. The 
return code register contains a hexadecimal 
code to indicate the reason for this 
return, as follows: 


Contents of 
Return Code 


Register Meaning 
00 Normal 
04 No attention occurred 
08 An asynchronous error atten- 
tion occurred | 
OC Poll list address or attention 


routine list address is not 
in the parameter list 

10 Output area address is not in 
the attention routine list 


Write-to-programmer messages are issued 
for the error conditions. For message 
explanations and programmer error checks, 


see IBM System/360 Operating System: -Pro- 


blem Determination Aids and Messages and 
Codes for GPS and GSP, GC27-6970. | : 


c 
* MAIN ROUTINE PROCESSING 


| | 
| | 
| 
ANALYZ POLST,POINTER l 
| . | 
| | : 
| POLST DC F'O? l 
l DS 2F l 
{POINTER DC F'O* l 
l DC A(KBRTN) | 
| Dc 2F'0' | 
| DC A (OUTAREA) l 
|OUTAREA DC 2F'0' | 
Oe aes as eee a es ee ee ee ee ee es ce ee oe een ae eee J 


Figure 11. Graphic attention analysis rou- 
tine, coding example 
EXAMPLE: Figure 11 illustrates applicable 


coding in a typical IBM 2260 Local graphic 
job that uses the ANALYZ macro instruction. 


POLST is the symbolic address of the 
first fullword entry in a list of DCB 
addresses and UCB index factors. Note that 
the first word in the list is set to zeros. 
POINTER is the symbolic address of the 
first entry in a five-word table that con- 
tains the entry address of the application 
program attention handling routines and the 
address of an output area (OUTAREA). 


SUGGESTIONS FOR THE APPLICATION PROGRAMMER: 
The application programmer opens the graph- 
ic device, thereby setting up the appropri- 
ate control blocks. A suggested initiali- 
zation procedure is the execution of a 
channel program, after the device is open, 
to inform an operator at the display sta- 
tion that the graphic program is now 
executing. Polling might then be started 
immediately by the application program if 
information resulting from attentions is to 
be processed. 


During the period that an attention 
might logically be expected from a display 
Station, polling should be done periodical- 
ly. The timing of this function may be 
handled either by employing the ANALYZ 
macro instruction at appropriate times dur- 
ing execution of the problem program, or by 
use of a Set Interval Timer (STIMER) system 
macro instruction which causes the System/ 
360 interval timer to employ the ANALYZ 
macro instruction at programmer-specified 


intervals. (See IBM System/360 Operating 


System; Supervisor Services and Macro 
Instructions, GC28-6646, for the format and 


use of the STIMER macro instruction.) 
However, if the timer is used for estab- 
lishing the interval between poll cycles, 
it is not available for establishing other 
task intervals. 
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Be ee ee ee 1 
| . | 
| . | 
| : | 
| OPEN DCB1 | 
| STIMER REAL, POLADR, | 
| ; DINTVL=TIME | 
| ° | 
[ : | 
[* MAIN ROUTINE PROCESSING | 
| ° | 
| , | 
| ° | 
| CLOSE DCB1 | 
| . | 
| : | 
| . | 
| DS OD | 
| TIME DC Z‘'00000020' | 
{|POLADR ANALYZ POLST, POINTER | 
|* IF NO ATTENTION, RETURN TO MAIN RTN | 
| . | 
| . | 
| ° | 
Re ee ee ae RE ed See Ae Oh eee ee oO ER Re eR Ste RE J 
Figure 12. Implementation of polling 

Note: If the application programmer 


wishes, he may wait for an attention by 
repeatedly executing the polling routine 
(that is, branching to the ANALYZ state- 
ment). It should be noted, however, that 
such a technique would defeat one of the 
primary purposes of a system having multi- 
programming capabilities. 


The coding of Figure 12 shows how the 
System/360 interval timer can be used to 
establish a polling interval. After the 
DCB for the device has been opened, use of 
the STIMER macro instruction provides an 
automatic transfer to the polling routine 
after a programmer-specified interval of 
real time (0.2 seconds in Figure 12). Until 
the interval has elapsed, processing con- 
tinues in the main routine. Action taken 
by the polling routine, ANALYZ, depends 
upon whether or not an attention occurred. 
Control is passed to the application pro- 
gram attention handling routine if there 
was an attention or is returned to the 
instruction following the ANALYZ macro 
instruction if an attention did not occur. 


GSERV--Graphic Attention Service Macro 
Instruction 


The GSERV macro instruction resets GCBs 
associated with attentions, so that an 
attention may not be handled more than 
once. This macro instruction is used by 
ANALYZ to reset the bits in the GCBs. If 
the application programmer elects to per- 
form his own attention analysis, GSERV must 
be used to reset (that is, zero) bits in 
the GCBs. The format of the GSERV macro 
instruction is: 
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acess SR. aa 1 
| Operation |Operand | 
{list item address, | 
gcb bit| (1) } 


list item address 
is the symbolic address of a 4-byte 
field, aligned on a fullword boundary, 
in the programmer's list of DCB 
addresses and UCB index factors. This 
list is constructed at open time if 
the POLST operand is written in the 
DCB macro instruction. The 4-byte 
field contains the address of the DCB 
and the UCB index factor that indi- 
cates the appropriate UCB for the 


device. 
(oe he ee 1. ; 
{UCB |DCB Address|jlist item 
| index | | address 
Bs esas Bee a J 
bit 0 7 8 31 
gcb bit 


specifies which bit in the GCB is to 
be reset. The value of “gcb bit" must 
be 1 for the 2260. 


If register notation is used, the param- 
eters must have been loaded into register 1 
before execution of the macro instruction. 
The format for loading the information into 
the register is as follows: 


eae tice A 
lgcb bit|list item| register 1 
| | address | 
Sarna ene 5 eae eaeree earn 4 

bit 0 7 8 31 


To define the bit to be reset, the pro- 
grammer codes the high-order byte in the 
register as follows: 


Type of GCB Bit to 
Attention be Reset Code 
Keyboard Entry 7 pc X*01' 


The address that comprises the three 
low-order bytes may be obtained from the 
poll list created by the OPEN macro 
instruction if the POLST operand was speci- 
fied in the DCB macro instruction. 


If the UCB address is invalid or if the 
device is not a graphic device, the job is 
abnormally terminated. 


After GSERV has reset the GCB bit, con- 
trol is returned to the next sequential 
instruction of the calling program. 


PROGRAMMING NOTES: The graphic control 
byte is set to zero when the first DCB is 
opened for any display station. 


APPENDIX D: SUMMARY OF OPERANDS 


The Summary of Operands, shown in this appendix, contains all of 
the macro instructions and indicates the allowable ways of writing the 
operands. The summary is designed so that it can be opened with all 
the macro instructions displayed when the descriptions are being read. 
The classifications used in the summary are as follows: 


SYM 
is any symbol valid in the assembler language. 
DEC INT 
are any decimal digits up to the value indicated in the assoc-— 
iated macro instruction description. If both SYM and DEC INT are 
checked, an absolute expression is also allowed. 
REGISTER 
is always coded within parentheses as follows: 
(2-12) - one of general registers 2 through 12, previously loaded 
with the right-adjusted value or address specified in 
the associated macro instruction description. The 
unused high-order bits must be set to zero. The register 
may be designated symbolically or with an absolute 
expression. 
(1) - general register 1, previously loaded as indicated above. 
The register can be designated only as (l). 
Note: Register notation may be used with E-form macro instructions only. 
RX TYPE 


any address that is valid in a RX-type instruction (e.g., LA) may 
be designated. 


A-TYPE ADCON TYPE 
any address that may be written in an A-type address constant may 
be designated. 


Note: 
e Underscoring indicates a default option; that is, if no operand 
is coded, the underscored operand is assumed. 


e Braces,{ }, indicate that one operand from a vertical or 
horizontal group must be chosen unless a default option is 
indicated. 


e The vertical stroke (|) separates alternative operands within 
a horizontal group. 


WRITTEN AS 


MACRO OPERANDS SYM DEC RX 


INSTRUCTION INT (2-12) type 


refer to macro description 


ANALYZ | polit adress 
refer to macro description 
MF=(L written as shown 
re written as shown 
parameter list name)§_ [x] x 
ae ae aaa 


ATINING [gach eddres SS 

R written as shown 
written as shown 
written as shown 

branch address) | fx 
CLEAR written as shown 
written as shown 

Pp Swritten'as shown 


[tienen NEAmeee (ENE cies (MUN ele cule; eee 


written as shown 
Se 
DAR [gacbaddress CTT xe 
written as shown 
written as shown 
et 8 Woe cae ae ee lls etal 
DCB |DSORG=GS. dT rittenassshown 


GTYPE= {BASIC | EXPRESS } 
DDNAME=ddname a 
EXLST=exit list address 


(RRs (ete ern 

ao nr eee ena 
CGNCP=number of blocks = ——sd| =x | SO Od 
a ieee eee SEE 

ee 


POLST=poll list address 


GCNIRL [deeb name SSSSCSdSCO % 
(ERS TERSW3 


os 
[deb address —SSCSC—“—s~C~sSC‘iY'SC‘iY' XT —SC~idSSSCSC~C~irCO ed 
ae ee ed 

(LEI 


GREAD dech name ee 
{DSM |DSMW|SMI|SMIW| DSB | DSBW 3 
dcb address PK a oe 


GWRITE [SC ANS a a 
{DSB | DSBW | EBW | EBWW| LNE | LNEW | EWL] EWLW } 
OPEN 


aes Eee ean 
GE ee a 

ee ee ser 

eel ee eae 


Pdce address | 
Tenth S™~—sCd Od 
Perea addres —SSSCSC~—SCS 
Bi ee ee 
2:1 “cana AGG SNES SAE GOMES SURE BORNE 
MF=(¢ L 
ae 


written as shown 


parameter list at 


MACRO OPERANDS SYM DEC 
INSTRUCTION INT (2-12) 


RX 

type 
AE EP= jentry point address ei DS ee ee ee eee et 
Gadel | ideas! NA seen neve som ene seams ceomen 
DCB=dcb_address Saar] acerca (niece cae (a eR: See 


address cae 


ATINTY P= “({A] SR }, 2260) | SAVE| RESTORE } 
FINE ap ep ae ace 


written as shown 
written as shown 


eo Oe Re i ee he od 


(*) Register notation may be used with E-form macro instructions only. 
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SPAR reece ee 
ans Seal 
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Where more than one reference is given, 
the first page number indicates the major 
reference. 


alphameric keyboard 1 
ANALYZ macro instruction 
ANALYZ pointer table 38 
area address operand 10,14 
attention 2,21,37 
attention handling 

basic 21-29,2 

express 30-40,2 
attention routine, application 

program 27-28,2 

attention type 22-23 
ATTNINQ macro instruction 
ATTNTYP 22,23 


37-40,7 


20221 521-23 429 


basic attention handling 21-29,2 
bit mask for resetting GCB 40 
buffer storage 1,10-12,14-16 


cathode ray tube 1 

CCWs (channel command words) 
CCW formats 34-36 

channel byte count 11,12 
channel command words (CCWs) 2,10-12,14-16 
character generator 1 

check symbol 11,12 


CLOSE macro instruction 19-20,5,25 
COMAREA 22-23,27-28,30 
completion flag in ECB 19-20 


conventions 3-4 
CRT (cathode ray tube) 1 
cursor 1,11-12,14-16 


DAR macro instruction 25,21,22,29 
data sontrol block 

(DCB) 6-8,2,5,9-10,13-14,17,19,20,22 
data entry 1 
data event control block 

(DECB) 6,9-10,12,13,17 
data extent block (DEB) 5 
DCB (data control 

block) 6-8,2,5,9-10,13-14,17,19,20,22 
DCB macro instruction 6-8,5 
DCBD macro instruction 8 
DD statement 5,7-9 
DDNAME 7 
DEB (data extent block) 5 
DECB (data event control 

block) 6,9-10,12,13,17 
destructive cursor 11 
DSB (read full display station buffer 
storage) 11,10,34 


DSB (write buffer storage) 14-15,13,35 


2,10-12,14-16 


INDEX 


DSBW (read full display station buffer 
storage without keyboard 

restore) 11,10,35 
DSBW (write buffer storage without 
keyboard restore) 15,13,35 
DSM (read display station manual input 
message) 10-11,34 
DSMW (read display station manual input 
message without keyboard 

restore) 11,10,34 
DSORG 6,8 


EBW (erase and write display station 
buffer storage) 15,13,35 
EBWW (erase and write display station 
buffer storage without keyboard 
restore) 15,13,35 
ECB (event control block) 
E-form macro instructions 
end of message 11-12 
EP 22,23 
EP=0 23 
error handling 2 
errors, read 12-13 
errors, write 16 
ERS (erase display station buffer 
storage) 17,36 
ERSW (erase display station buffer storage 
without keyboard restore) 17-18,36 
event control block (ECB) 6,12,16,18-20 
EWL (erase and write display station 
line address) 16,14,36 


6,12,16,18-20 
4,6,10,14,17 


-EWLW (erase and write display station line 


address without keyboard 
restore) 16,14,36 
EXLST 7 


Express attention handling 37-40,2 


format illustration conventions 3-4 


GACB (graphic attention control 


block) 21-29 
gacb list address operand 24,25 
GCB 37-40 
gcb bit operand 40 
GCNTRL macro instruction 17-18,5 
GNCP 7-9 
graphic attention control block 
(“GACB) 21-29 


graphic attention service routine 40,37 
GREAD macro instruction 9-13,5 

GSERV macro instruction 40 

GTYPE 7 

GWRITE macro instruction 10-16,5 
IBM 1053 printer 5,10,14,17 

IBM 1053 printer adapter unit 1 


Index 43 


IBM 2260 local 1 
IBM 2260 remote 1 
IBM 2701 data adapter unit 1 
IBM 2848 display control 1 
input/output block (IOB) 6-9 
input/output control 5-20,2 
input/output control routine 6 
input/output macro instructions 5 

CLOSE 19-20,5,25 

DCB 6-8,5 | 

GCNTRL 17-18,5 

GREAD 9-13,5 

GWRITE 10-16,5 

OPEN 8-9,5 
IOB (input/output block) 6-9 
IX 23 


keyboard 1,21,37 


length operand 10,14 
L-form macro instructions 4,6,10,14,17 
line addressing 1,15-16 
LNE (write display station line 

address) 15,13,36 
LNEW (write display station line address 
without keyboard restore) 15,14,36 
linkage conventions 4 

list item address operand 40 


MACRF codes 6-7 
macro-form operand 
(MF) 4,6,9,10,14,17,19,22,24-26,38 
MODE 26 
MVT 3,20,28-29 


new line symbol 11 
non-destructive cursor 1,11 
numeric keyboard 1 


OPEN macro instruction | 8-9,5,20 
output of ANALYZ 38-39 


parameter list address operand 26 
pointer address operand 38 | 
pointer table for attention handling 38 
polling 37-40 | | 
polling interval 39-40 
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polling techniques 


POLST 7-8, 


38-39 


37, 


polst address operand 


post the ECB 


19-20,28 


POST macro instruction 
printer adapter unit 
priority among attention routines 24,21-22 
problem determination 


PRTY 24 


read error 12-13 
register notation 
reset GCB 40 
return codes 
ANALYZ 39 
GCNTRL 18 
GREAD +3 
GWRITE 16 


1 


39-40 © 
38 


28 


279734160718 


3,13,16,18 


RETURN macro instruction 28 


SAEC macro instruction 


sample program 


30-33 


21-24,29 


SMI (read display station short manual 


input message) 


11,10,34 


SMIW (read display station short manual 
input message without keyboard 


restore) 


11,10,34 


SPAR macro instruction 


start symbo 


1 11 


24-25,21,22,29 


STIMER macro instruction 39-40 
stop sequence 11 


synchronous 


error 


system generation 


terminology 
TYPE 23 


type operand 


mM 


2 
2 


10,13-14,17 


UCB (unit control block) 5-6 


UCB index 
UNIT 26 


5-6 


unit control block (UCB) 5-6 
unit operand 6,10,14,17 


wait for an attention 
WAIT macro instruction 


Wait state 
write error 


25-26 
16 


28 
18-19,5,28 
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